tsconfig.json

{
  "compilerOptions": {
    /* ECMAScript 설정 */
    "target": "ESNext", // 최신 브라우저와 ESNext 문법 지원
    "lib": ["DOM", "DOM.Iterable", "ESNext"], // DOM API와 최신 ECMAScript 라이브러리

    /* 모듈 설정 */
    "module": "ESNext", // ES 모듈 사용
    "moduleResolution": "node", // Node.js 스타일 모듈 해석
    "esModuleInterop": true, // CommonJS 호환성 지원
    "allowSyntheticDefaultImports": true, // 기본값 import 허용
    "resolveJsonModule": true, // JSON 파일 import 가능
    "allowImportingTsExtensions": true, // .ts 확장자를 포함한 import 허용
    "isolatedModules": true, // 모듈별 독립적 컴파일
    "moduleDetection": "force", // 모듈 파일 강제 감지

    /* JSX / React 설정 */
    "jsx": "react-jsx", // React 17+ JSX 자동 변환
    "types": ["react", "react-dom"], // React와 React-DOM 타입 추가

    /* 타입 검사 */
    "strict": true, // 엄격한 타입 검사 활성화
    "noUnusedLocals": true, // 사용하지 않는 지역 변수 경고
    "noUnusedParameters": true, // 사용하지 않는 파라미터 경고
    "noFallthroughCasesInSwitch": true, // switch 문의 누락 방지

    /* import alias */
    "baseUrl": "./", // 프로젝트 루트를 기본 경로로 설정
    "paths": {
      "@/*": ["src/*"]
    },

    /* 기타 */
    "forceConsistentCasingInFileNames": true, // 대소문자 일관성 강제
    "skipLibCheck": true, // 라이브러리 타입 검사 생략
    "noEmit": true // 출력 파일 생성 방지
  },
  "include": ["src"], // 검사할 파일 경로
  "exclude": ["node_modules", "dist"] // 제외할 파일 경로
}