dev-env / tsconfig

UNIAI 프런트엔드 프로젝트에서 공통으로 사용하는 TypeScript 프리셋 모음입니다.

디렉터리 구성

• essentials/base.json: 환경에 의존하지 않는 언어 레벨 옵션을 정의한 최상위 프리셋.
• essentials/node.json: Node 런타임/SSR용 기본 설정. moduleResolution: "NodeNext"와 types: ["node"]를 제공합니다.
• essentials/client.json: 브라우저 런타임에서 필요한 DOM 라이브러리와 번들러 해상도를 포함한 클라이언트 전용 프리셋.
• essentials/react.json: React 프로젝트 공통 옵션(jsx: "react-jsx", useDefineForClassFields)을 모은 프리셋.

앱 실행환경 프리셋

• apps/vite.json: essentials/react.json을 확장해 Vite 번들링에 필요한 옵션과 엄격한 no-unused 규칙을 추가합니다.
• apps/vite.node.json: Vite 기반 SSR/라이브러리 빌드를 위해 essentials/node.json을 확장한 프리셋입니다.
• apps/next.json: App Router 기준 Next.js 프로젝트를 위한 프리셋으로 Next 공식 플러그인을 활성화합니다.
• apps/next.legacy.json: Pages Router 호환을 위해 남겨둔 레거시 프리셋(신규 프로젝트에서는 사용하지 않습니다).

사용 예시

{
  "extends": "@uniai-fe/tsconfig/vite.json",
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}

프로젝트 목적에 맞는 프리셋을 extends로 지정하고, 로컬 경로나 include/exclude만 추가해 사용하는 것을 권장합니다.