AI 프롬프트로 TypeScript 200% 활용하기

1. 역할 / 2. 맥락 / 3. 지시 / 4. 형식

TS 기본 타입 7개(string/number/boolean/array/tuple/object/null)와
any / unknown / never / void 차이를 표로 정리해줘.
각 타입의 잘못된 사용 예시도 5개 포함.

interface와 type 차이를 비교표로 정리해줘.
각 행: 선언 병합 / 유니온 / 인터섹션 / 매핑 / 추천 사용처.
실무에서 둘 다 쓰는 케이스 + 개인적 권장 기준 포함.

리터럴 유니온(type Status = 'idle' | 'loading' | 'success' | 'error')을
실전에서 어떻게 활용하는지 코드 + 좁히기(narrowing) 예시 5개로 보여줘.
as const 패턴 + 매핑 객체 + switch exhaustive 검증 포함.

타입 가드 4종류(typeof / in / instanceof / 사용자 정의)를
각각 예시 + 언제 무엇을 쓰는지 결정 트리로 정리해줘.
안전하지 않은 타입 어서션(as)과 비교.

제네릭의 흐름을 설명해줘.
1) 기본 형태 / 2) extends 제약 / 3) 기본 타입 매개변수 /
4) 다중 제네릭 / 5) 실전 useFetch<T>.
각 단계 코드와 추론 결과(Hover 시 표시)를 주석으로.

유틸리티 타입 8개(Partial/Required/Readonly/Pick/Omit/Record/Exclude/Extract)를
같은 데이터(User 인터페이스)로 각각 변형 예시 + 언제 쓰는지
실전 시나리오로 정리해줘.

enum의 단점(런타임 코드 생성, tree-shakable 아님) 때문에
2026년에는 const + as const + 리터럴 유니온이 더 권장돼.
같은 상태값을 enum / const + as const / 리터럴 유니온
3가지로 작성하고 컴파일 결과·번들 크기 비교해줘.

.d.ts(declaration file)와 module declaration의 차이를 정리해줘.
외부 JS 라이브러리(예: lodash)에 타입을 추가하는 방법 +
전역 타입 확장 / 모듈 경로 별칭(paths) / @types 패키지.

조건부 타입(T extends U ? X : Y)과 infer를
실전 예시로 알려줘.
1) ReturnType<T> / 2) Awaited<T> / 3) Parameters<T> 직접 구현 +
분배 조건부 타입(distributive)의 함정도 코드로 보여줘.

Next.js + tRPC + Zod로 타입 안전 API를 설계해줘.
서버 라우터 정의 → 클라이언트 자동 타입 추론 흐름 +
Zod로 런타임 입력 검증 + 에러 매핑 + 캐싱.
실제 코드 + 타입 흐름 다이어그램.

중간 규모 JS 프로젝트(50파일)의 TS 전환 로드맵을 설계해줘.
1) allowJs로 안전망 / 2) 진입점부터 .ts로 변경 /
3) any 우선 → 점진적 좁히기 / 4) strict 옵션 단계별 활성화 /
5) codemod로 일괄 변환 / 6) CI 게이트.
각 단계 위험·측정·롤백 전략 포함.

// ❌ 나쁜 프롬프트: 'fetch 함수 만들어줘'
async function badFetch(url: string): Promise<any> {
  const res = await fetch(url);
  return res.json();
}
// 문제: any 반환, 에러 무시, 응답 검증 없음


// ✅ 좋은 프롬프트: 제네릭 + Zod + Result 타입
import { z, ZodSchema } from 'zod';

type Result<T> = { ok: true; data: T } | { ok: false; error: string };

async function goodFetch<T>(url: string, schema: ZodSchema<T>): Promise<Result<T>> {
  try {
    const res = await fetch(url);
    if (!res.ok) return { ok: false, error: `HTTP ${res.status}` };
    const json = await res.json();
    const parsed = schema.safeParse(json);
    if (!parsed.success) return { ok: false, error: parsed.error.message };
    return { ok: true, data: parsed.data };
  } catch (err) {
    return { ok: false, error: (err as Error).message };
  }
}

// 사용 — 타입이 자동으로 흐름
const UserSchema = z.object({
  id: z.number(),
  name: z.string(),
  email: z.string().email(),
});

const result = await goodFetch('/api/me', UserSchema);
if (result.ok) {
  console.log(result.data.email); // 자동으로 string
} else {
  console.error(result.error);
}

/*
  📊 비교:
  | 항목         | ❌ 나쁜 | ✅ 좋은 |
  | 반환 타입     | any   | T (제네릭) |
  | 에러 처리     | 무시  | Result 분기 |
  | 응답 검증     | 없음  | Zod safeParse |
  | 타입 안전성   | 0%   | 100% (런타임+컴파일) |
  → 프롬프트의 구체성이 코드 품질을 결정합니다!
*/