TypeScript 6.0 마이그레이션 가이드 — strict 기본값화, ESM 전환, Go 컴파일러 전환 준비

strict: true 영향 예시 — 업그레이드 전후 비교
// TypeScript 5.x (strict: false 기본) — 에러 없음
function getLength(s: string | undefined): number {
  return s.length;  // undefined일 때 런타임 에러 가능성 있지만 타입 에러는 아님
}

// TypeScript 6.0 (strict: true 기본) — 컴파일 에러
function getLength(s: string | undefined): number {
  return s.length;
  // Error: Object is possibly 'undefined'. ts(2532)
}

// 수정 방법 1: 옵셔널 체이닝
function getLength(s: string | undefined): number {
  return s?.length ?? 0;
}

// 수정 방법 2: 타입 가드
function getLength(s: string | undefined): number {
  if (s === undefined) return 0;
  return s.length;
}

// 마이그레이션 중 임시 우회 (tsconfig.json)
// "strict": false  ← 명시적으로 false 설정하면 이전 동작 유지
// 또는 개별 플래그로 점진적 적용:
// "strictNullChecks": true  ← 하나씩 켜기

tsconfig.json — TypeScript 6.0 업그레이드 시 주요 설정 검토
// TypeScript 6.0 기본값이 변경된 항목들
// (명시하지 않으면 이 값들이 기본으로 적용됨)
{
  "compilerOptions": {
    "strict": true,          // 6.0 신규 기본값
    "module": "esnext",      // 6.0 신규 기본값 (이전: commonjs)
    "target": "es2022",      // 6.0 신규 기본값 (이전: es3)
    "moduleResolution": "bundler", // 6.0 신규 기본값
    "verbatimModuleSyntax": true   // 6.0 신규 기본값
  }
}

// Node.js 서버 프로젝트 — CJS 유지가 필요한 경우
{
  "compilerOptions": {
    "module": "commonjs",    // 명시적으로 CJS 지정
    "moduleResolution": "node",
    "strict": false          // 마이그레이션 전 임시
  }
}

// Next.js 15+ 프로젝트 — 번들러 처리 위임
{
  "compilerOptions": {
    "module": "esnext",
    "moduleResolution": "bundler",  // Next.js 권장
    "strict": true
  }
}

Temporal API 기본 사용 예시 — Date 객체와 비교
// 기존 Date 방식 (여전히 동작하지만 문제가 많음)
const now = new Date();
const year = now.getFullYear();
const month = now.getMonth() + 1;  // 0-indexed이라 +1 필요

// Temporal API (TypeScript 6.0 lib에 기본 포함)
const today = Temporal.Now.plainDateISO();
console.log(today.year);   // 2026
console.log(today.month);  // 4 (4월, 1-indexed)
console.log(today.day);    // 5

// 타임존 명시적 처리
const seoulNow = Temporal.Now.zonedDateTimeISO('Asia/Seoul');
const nyNow = Temporal.Now.zonedDateTimeISO('America/New_York');

// Immutable 날짜 연산
const deadline = today.add({ days: 30 });
// today는 변경되지 않음, deadline이 새 객체로 반환됨
console.log(deadline.toString());  // 2026-05-05

// 날짜 차이 계산
const start = Temporal.PlainDate.from('2026-01-01');
const end = Temporal.PlainDate.from('2026-04-05');
const diff = start.until(end);
console.log(diff.days);  // 94

// TypeScript 6.0: 이 타입들이 tsconfig lib 없이 바로 사용 가능
function formatDate(date: Temporal.PlainDate): string {
  return `${date.year}년 ${date.month}월 ${date.day}일`;
}

TypeScript 6.0 마이그레이션 — 단계별 tsconfig.json 설정
// 1단계: 버전만 올리고 기존 동작 유지 (기존 코드 에러 없음)
{
  "compilerOptions": {
    "strict": false,
    "module": "commonjs",
    "target": "es2020"
  }
}

// 2단계: strictNullChecks만 먼저 켜기 (가장 임팩트 큰 항목)
{
  "compilerOptions": {
    "strict": false,
    "strictNullChecks": true,
    "module": "commonjs"
  }
}

// 3단계: 나머지 strict 하위 플래그 순차 적용
{
  "compilerOptions": {
    "strict": false,
    "strictNullChecks": true,
    "noImplicitAny": true,
    "strictPropertyInitialization": true
  }
}

// 최종 목표: 완전한 strict: true
{
  "compilerOptions": {
    "strict": true,
    "module": "esnext",
    "target": "es2022"
  }
}

# 업그레이드 명령
npm install --save-dev typescript@6

# 에러 현황 파악 (수정 없이 에러 수만 확인)
npx tsc --noEmit 2>&1 | grep 'error TS' | wc -l