eslint-config-minsug/README.md

Minsug shareable ESLint config (v9 Flat)

# eslint-config-minsug

## 소개

`eslint-config-minsug`는 TypeScript + React 프로젝트를 위한 ESLint 9 플랫(Flat) 구성 공유 패키지입니다. 실사용 현장에서 검증된 추천 규칙과 import/정렬, Prettier 연동을 함께 제공하므로 별도 설정 없이 일관된 코드 품질을 확보할 수 있습니다.

## 요구 사항

- `eslint` 9 이상 (Flat Config 전용)
- ESM 기반 구성 파일(`eslint.config.js` 또는 `eslint.config.mjs`)
- 프로젝트에 `tsconfig.json`이 존재해야 `typescript-eslint` 타입 체크 규칙이 활성화됩니다.

## 설치

```bash
npm install --save-dev eslint@^9 eslint-config-minsug
# 또는 pnpm/yarn 등 선호하는 패키지 매니저 사용
```

## 사용 예시 (Flat Config)

```js
// eslint.config.mjs
import minsugConfig from "eslint-config-minsug";

const [ignoreConfig, baseConfig] = minsugConfig;

export default [
  ignoreConfig,
  {
    ...baseConfig,
    files: ["**/*.{ts,tsx,js,jsx}"],
  },
];
```

또는

```js
import { defineConfig } from "eslint/config";
import minsugConfig from "eslint-config-minsug";

export default defineConfig([
  { files: ["**/*.{ts,tsx,js,jsx}"], extends: [minsugConfig] },
]);
```

위 예시는 `dist` 디렉터리를 전역 제외 대상으로 유지하면서 TypeScript/JavaScript/React 파일에만 규칙을 적용합니다.

## 포함된 주요 규칙

- **기본 세트**: `@eslint/js`의 `recommended`, `typescript-eslint`의 `recommendedTypeChecked`
- **React & UI**: `eslint-plugin-react`, `eslint-plugin-react-hooks` 최신 추천, `eslint-plugin-jsx-a11y`
- **Import 품질**: `eslint-plugin-import`, `eslint-plugin-unused-imports`, `eslint-plugin-simple-import-sort`
- **코드 포맷**: `eslint-plugin-prettier`로 Prettier 포맷 오류를 ESLint 에러로 처리
- **팀 컨벤션**: `_` prefix 파라미터 허용, `no-console`은 `warn/error`만 예외, 타입 import 일관성과 switch exhaustiveness 강제