hia-frontend-typescript-config 0.0.1

package/README.md

@@ -0,0 +1,66 @@
+# hia-frontend-typescript-config
+
+HIA AI 프로젝트 공통 TypeScript 설정 패키지입니다.
+
+## 설치
+
+```bash
+pnpm add -D hia-frontend-typescript-config
+```
+
+## 사용법
+
+용도에 맞는 config를 `extends`로 참조하세요.
+
+### base.json — 공통 기본 설정
+
+```json
+// tsconfig.json
+{
+  "extends": "hia-frontend-typescript-config/base.json"
+}
+```
+
+### nextjs.json — Next.js 앱 / 패키지 (기본)
+
+`base.json` + `jsx: preserve` + `noEmit: true` (Next.js 컴파일러가 직접 처리)
+
+```json
+// tsconfig.json
+{
+  "extends": "hia-frontend-typescript-config/nextjs.json",
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
+}
+```
+
+### node.json — Node.js 환경 (유틸, CLI 등)
+
+`base.json` + `module: CommonJS` + `moduleResolution: node`
+
+```json
+// tsconfig.json
+{
+  "extends": "hia-frontend-typescript-config/node.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}
+```
+
+## compilerOptions 주요 설정
+
+| 옵션                 | 값        | 설명                               |
+| -------------------- | --------- | ---------------------------------- |
+| `target`             | `ES2020`  | 출력 JS 버전                       |
+| `module`             | `ESNext`  | 모듈 시스템 (node.json은 CommonJS) |
+| `moduleResolution`   | `bundler` | tsup/vite 환경 최적화              |
+| `strict`             | `true`    | 엄격한 타입 검사 전체 활성화       |
+| `declaration`        | `true`    | `.d.ts` 타입 파일 생성             |
+| `declarationMap`     | `true`    | 타입 파일 소스맵 생성              |
+| `sourceMap`          | `true`    | 소스맵 생성                        |
+| `noUnusedLocals`     | `true`    | 미사용 로컬 변수 오류              |
+| `noUnusedParameters` | `true`    | 미사용 함수 파라미터 오류          |
+| `skipLibCheck`       | `true`    | node_modules 타입 검사 생략        |

package/base.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "declaration": true,
+    "declarationMap": true,
+    "esModuleInterop": true,
+    "incremental": false,
+    "isolatedModules": true,
+    "lib": ["es2022", "DOM", "DOM.Iterable"],
+    "module": "NodeNext",
+    "moduleDetection": "force",
+    "moduleResolution": "NodeNext",
+    "noUncheckedIndexedAccess": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "target": "ES2022"
+  }
+}

package/nextjs.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "noEmit": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }]
+  }
+}

package/node.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["ES2022"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "target": "ES2022"
+  }
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "hia-frontend-typescript-config",
+  "version": "0.0.1",
+  "description": "HIA 공통 TypeScript 설정",
+  "files": [
+    "base.json",
+    "react.json",
+    "nextjs.json",
+    "node.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "typescript": ">=5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "lint": "echo 'No lint for config package'"
+  }
+}

package/react.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx"
+  }
+}