11장: 프로젝트 설정과 모노레포 타입 전략

{
  "compilerOptions": {
    // === 타입 검사 ===
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "exactOptionalPropertyTypes": true,
    "noFallthroughCasesInSwitch": true,
 
    // === 모듈 시스템 ===
    "module": "nodenext",
    "moduleResolution": "nodenext",
    "verbatimModuleSyntax": true,
    "rewriteRelativeImportExtensions": true,
 
    // === 출력 ===
    "target": "es2024",
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
 
    // === 5.x 신규 옵션 ===
    "erasableSyntaxOnly": true,
    "isolatedDeclarations": true
  }
}

{
  "compilerOptions": {
    "strict": true,
    // 위 옵션은 아래를 모두 활성화:
    // "strictNullChecks": true,        — null/undefined 엄격 검사
    // "strictFunctionTypes": true,     — 함수 파라미터 반변성 검사
    // "strictBindCallApply": true,     — bind/call/apply 타입 검사
    // "strictPropertyInitialization": true, — 클래스 프로퍼티 초기화 검사
    // "noImplicitAny": true,           — 암시적 any 금지
    // "noImplicitThis": true,          — 암시적 this 타입 금지
    // "alwaysStrict": true,            — "use strict" 강제
    // "useUnknownInCatchVariables": true  — catch의 error를 unknown으로
  }
}

const arr = [1, 2, 3];
 
// noUncheckedIndexedAccess: false
arr[0]; // number
 
// noUncheckedIndexedAccess: true
arr[0]; // number | undefined
// 안전한 접근
const first = arr[0];
if (first !== undefined) {
  console.log(first.toFixed(2)); // OK
}

// 타입만 import할 때는 반드시 'import type' 사용
import type { User } from "./types";
 
// 값을 import할 때는 일반 import 사용
import { createUser } from "./utils";
 
// 혼합: import에서 타입과 값을 구분
import { createUser, type UserConfig } from "./users";

// 사용 불가
enum Status { Active, Inactive }  // Error
namespace Utils { export function helper() {} }  // Error
class Service {
  constructor(private name: string) {}  // Error: 파라미터 프로퍼티
}
 
// 대안
const Status = { Active: 0, Inactive: 1 } as const;
type Status = (typeof Status)[keyof typeof Status];
 
function helper() {}
export { helper as Utils_helper };
 
class Service {
  private name: string;
  constructor(name: string) {
    this.name = name;
  }
}

// 소스 코드
import { helper } from "./utils.ts";
import { config } from "../config.ts";
 
// 출력 (.js)
import { helper } from "./utils.js";
import { config } from "../config.js";

{
  "compilerOptions": {
    "composite": true,
    "declaration": true,
    "declarationMap": true,
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "include": ["src"]
}

{
  "compilerOptions": {
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "references": [
    { "path": "../shared" }
  ],
  "include": ["src"]
}

{
  "files": [],
  "references": [
    { "path": "./packages/shared" },
    { "path": "./packages/api" },
    { "path": "./packages/web" }
  ]
}

# 전체 빌드 (의존성 순서 자동 해결)
tsc --build
 
# 특정 프로젝트만 빌드
tsc --build packages/api
 
# 강제 재빌드
tsc --build --force
 
# 클린 빌드
tsc --build --clean

{
  "compilerOptions": {
    "isolatedDeclarations": true,
    "declaration": true
  }
}

// Error: 반환 타입이 명시되지 않음
export function add(a: number, b: number) {
  return a + b;
}
 
// OK: 반환 타입 명시
export function add(a: number, b: number): number {
  return a + b;
}
 
// 내부 함수는 추론 가능 (export되지 않으므로)
function internal(x: number) {
  return x * 2; // OK
}

// packages/ui/package.json
{
  "name": "@myorg/ui",
  "main": "./src/index.ts",
  "types": "./src/index.ts",
  "exports": {
    ".": {
      "types": "./src/index.ts",
      "default": "./src/index.ts"
    }
  }
}

// packages/ui/package.json
{
  "name": "@myorg/ui",
  "main": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "types": "./dist/index.d.ts",
      "import": "./dist/index.js"
    }
  }
}

{
  "compilerOptions": {
    "strict": true,
    "target": "es2024",
    "module": "nodenext",
    "moduleResolution": "nodenext",
    "verbatimModuleSyntax": true,
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
    "skipLibCheck": true,
    "noUncheckedIndexedAccess": true,
    "isolatedModules": true
  }
}

{
  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
    "composite": true,
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "references": [
    { "path": "../shared" }
  ],
  "include": ["src"]
}

{
  "compilerOptions": {
    "paths": {
      "@myorg/shared": ["../shared/src"],
      "@myorg/shared/*": ["../shared/src/*"],
      "@myorg/ui": ["../ui/src"],
      "@myorg/ui/*": ["../ui/src/*"]
    }
  }
}

{
  "dependencies": {
    "@myorg/shared": "workspace:*"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "typescript": "^5.8.0"
  }
}

{
  "compilerOptions": {
    "incremental": true,
    "tsBuildInfoFile": "./.tsbuildinfo"
  }
}

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

{
  "scripts": {
    "typecheck": "tsc --noEmit",
    "build": "esbuild src/index.ts --bundle --outdir=dist",
    "build:types": "tsc --emitDeclarationOnly",
    "ci": "pnpm typecheck && pnpm build && pnpm build:types"
  }
}

{
  "compilerOptions": {
    "module": "esnext",
    "moduleResolution": "bundler"
  }
}

{
  "compilerOptions": {
    "module": "nodenext",
    "moduleResolution": "nodenext"
  }
}