TypeScript 로고
TypeScript

이펙티브 타입스크립트 — 실무에서 바로 쓰는 핵심 팁

실무에서 바로 꺼내 쓸 수 있는 TypeScript 핵심 팁을 압축해 정리한다. satisfies 우선·as 자제·any 대신 unknown·const 단언·유틸리티 타입 활용 같은 습관과, 지금까지 걸어온 학습 여정을 한눈에 돌아본다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

타입 설계 베스트 프랙티스

좋은 타입을 설계하는 핵심 원칙들을 정리한다. 불가능한 상태를 표현 불가능하게 만드는 판별 유니온, 타입은 정확한 만큼만 넓게 잡는 절제, 외부 입력은 경계에서만 검증하는 패턴, 추론을 믿되 공개 API는 명시하는 균형까지, 실전에서 코드를 더 안전하고 읽기 쉽게 만드는 설계 습관을 다룬다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

자주 만나는 에러 메시지 읽기

TypeScript의 길고 무서워 보이는 에러 메시지를 빠르게 해석하는 법을 다룬다. 에러 코드·소스 타입·타깃 타입으로 메시지 구조를 분해하는 법, TS2322·TS2339·TS2345·TS18048 같은 단골 에러의 원인과 고치는 방향, 그리고 중첩된 'because' 체인을 읽는 요령까지 정리한다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

대규모 코드베이스 전략

수백 개 모듈과 여러 패키지가 얽힌 대규모 TypeScript 프로젝트를 다루는 구조적 전략을 정리한다. 프로젝트 레퍼런스로 의존성을 쪼개 부분 빌드를 가능하게 하는 법, composite·incremental로 캐시를 활용하는 설정, 그리고 폴더 구조와 배럴 파일에 대한 현실적인 조언을 담았다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

타입 체크 성능 끌어올리기

tsc가 느려지는 원인을 측정 가능한 수치로 진단하고 줄이는 법을 다룬다. extendedDiagnostics와 generateTrace로 병목을 찾는 방법, 거대한 유니온·깊은 조건부 타입·과도한 추론이 만드는 비용, skipLibCheck와 명시적 반환 타입 같은 실전 처방까지 정리한다.

· 8 min read · PALDYN Team
TypeScript 로고
TypeScript

any를 체계적으로 제거하기

코드에 남은 any를 체계적으로 걷어내는 법을 다룬다. any가 유입되는 경로(JSON.parse, catch, 서드파티, 캐스팅)별 대체 전략, any 대신 unknown을 안전한 기본값으로 쓰는 이유, ESLint의 no-unsafe 규칙과 type-coverage로 재유입을 막는 가드까지 정리한다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

점진적으로 strict 강화하기

strict: true를 한 번에 켜는 대신, 안에 든 플래그를 하나씩 켜며 타입을 단단히 하는 법을 다룬다. noImplicitAny부터 strictNullChecks까지 권장 활성화 순서, overrides로 파일·디렉터리별 적용, type-coverage를 이용한 래칫 전략으로 후퇴를 막는 방법을 정리한다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

JSDoc으로 타입 작성하기

TypeScript 문법을 쓰지 않고 자바스크립트 파일에 JSDoc 주석만으로 타입을 입히는 법을 다룬다. @param·@returns·@type·@typedef·@template의 사용법, import 타입과 캐스팅, @satisfies, 그리고 JSDoc과 .ts 중 무엇을 언제 선택할지까지 정리한다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

allowJs와 checkJs

마이그레이션의 출발점인 allowJs와 checkJs 옵션을 자세히 다룬다. 두 옵션이 만드는 네 가지 상태, JS를 컴파일에 포함하는 것과 타입 검사하는 것의 차이, 파일 상단 @ts-check·@ts-nocheck로 전역 설정을 개별 재정의하는 법, maxNodeModuleJsDepth까지 정리한다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 마이그레이션 전략

기존 자바스크립트 코드베이스를 TypeScript로 옮기는 전체 전략을 다룬다. 한 번에 strict로 가지 않고 빌드 연결·파일 변환·strict 강화·완료의 4단계로 나누는 로드맵, 의존성 말단부터 변환하는 순서, ts-nocheck를 활용한 점진 전환까지 큰 그림을 정리한다.

· 8 min read · PALDYN Team
TypeScript 로고
TypeScript

타입과 시맨틱 버저닝

타입 변경도 사용자 코드를 깨뜨리면 호환성 깨짐(breaking change)이다. 어떤 타입 변경이 메이저이고 어떤 것이 마이너인지, TypeScript 컴파일러 버전 자체가 호환 표면이 되는 이유, peerDependencies와 버전 매트릭스 테스트까지 라이브러리 유지보수 관점에서 정리한다.

· 8 min read · PALDYN Team
TypeScript 로고
TypeScript

타입을 포함한 라이브러리 배포하기

TypeScript 라이브러리를 npm에 배포할 때 타입까지 올바르게 전달하는 법을 다룬다. package.json의 exports 맵과 types 조건 순서, ESM/CJS 듀얼 패키지, files 필드, 그리고 attw·publint로 배포 전 자동 검증하는 절차를 정리한다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

.d.ts 번들링

여러 파일로 흩어진 타입 선언을 단일 진입점 하나로 묶는 .d.ts 번들링을 다룬다. 왜 번들링이 필요한지, api-extractor·dts-bundle-generator·tsup 같은 도구의 선택 기준, internal 타입 숨기기와 선언 맵까지 라이브러리 배포 관점에서 정리한다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

SWC와 esbuild의 타입 처리

SWC와 esbuild는 TypeScript를 매우 빠르게 변환하지만 타입 검사는 하지 않는다. 변환과 타입 검사의 분리, isolatedModules 제약, const enum과 type-only import 문제, 그리고 빠른 빌드와 안전한 타입 검사를 함께 가져가는 실무 구성을 정리한다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

타입을 테스트하기: expectTypeOf와 tsd

런타임 테스트가 값의 정확성을 보장한다면, 타입 테스트는 타입의 모양을 보장한다. Vitest의 expectTypeOf, tsd, @ts-expect-error를 활용해 제네릭 함수와 유틸리티 타입의 추론 결과를 컴파일 타임에 검증하는 방법을 정리한다.

· 9 min read · PALDYN Team
TypeScript 로고
TypeScript

Vitest와 Jest 타이핑

Vitest와 Jest로 TypeScript 테스트를 작성할 때 타입을 살리는 법을 정리합니다. 전역 API 타입 설정, 제네릭 vi.fn으로 목 시그니처 보존, vi.mocked·jest.mocked로 모듈 목 타이핑, expect 매처의 타입 안전성, 비동기 단언까지 실무 관점으로 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

AbortController 타이핑

AbortController와 AbortSignal을 TypeScript로 다루는 법을 정리합니다. controller·signal의 타입, signal을 함수 옵션으로 받는 시그니처, AbortError를 catch에서 좁혀 구분하기, AbortSignal.timeout과 any 조합, 이벤트 리스너 자동 해제 패턴까지 실무 관점으로 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

비동기 이터레이터 타이핑

비동기 이터레이터와 async 제너레이터를 TypeScript로 타이핑하는 법을 정리합니다. async function*의 AsyncGenerator 반환 타입, for await...of의 타입 흐름, AsyncIterable·AsyncIterator·AsyncGenerator의 차이, 페이지네이션과 스트림 처리에 적용하는 실전 예시까지 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

Promise 깊이 타이핑하기

Promise를 TypeScript로 깊이 있게 타이핑하는 법을 정리합니다. Promise<T>의 의미와 then 체이닝의 타입 흐름, 자동 평탄화, Promise.all·allSettled·race·any의 반환 타입 차이, Awaited 유틸리티, reject가 타입에 잡히지 않는 한계와 대응까지 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

제네릭 컴포넌트 만들기

재사용 가능한 React 컴포넌트를 제네릭으로 타이핑하는 법을 정리합니다. 타입 인자가 props 사이를 흐르는 원리, .tsx에서 제네릭 화살표 함수가 막히는 문법 함정과 해결, 제약(extends)으로 키 안전성 확보, forwardRef와 제네릭을 함께 쓰는 법까지 실무 관점으로 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

React 이벤트 핸들러 타이핑

React 합성 이벤트(SyntheticEvent)를 TypeScript로 타이핑하는 법을 정리합니다. ChangeEvent·MouseEvent·FormEvent·KeyboardEvent의 엘리먼트 제네릭, target과 currentTarget의 차이, 인라인 핸들러의 자동 추론과 분리 함수의 명시, EventHandler 별칭까지 실무 관점으로 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

React Context 타이핑

React Context를 TypeScript로 안전하게 만드는 법을 정리합니다. createContext의 제네릭 선언, 가짜 기본값의 위험과 undefined 기본값, Provider 밖 사용을 차단하는 가드 커스텀 훅, 상태와 dispatch를 두 Context로 분리하는 패턴까지 실무 관점으로 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

ref와 forwardRef 타이핑

React에서 ref를 TypeScript로 안전하게 다루는 법을 정리합니다. useRef의 DOM 참조용과 가변 컨테이너용 타입 차이, null 체크, forwardRef의 두 제네릭 인자 순서, useImperativeHandle로 노출 API 타이핑, React 19에서 ref가 일반 prop이 된 변화까지 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

React Hooks 타이핑 — useState부터 useReducer까지

React Hook을 TypeScript로 안전하게 쓰는 법을 정리합니다. useState의 추론과 제네릭 명시 기준, null·빈 배열 함정, useReducer를 판별 유니온 Action으로 타이핑하기, useCallback·useMemo의 추론, 커스텀 Hook의 반환값을 const 단언으로 튜플 고정하기까지 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

React Props와 children 타이핑

React 컴포넌트의 props를 TypeScript로 안전하게 선언하는 법을 정리합니다. interface와 type 중 무엇을 쓸지, children을 ReactNode·ReactElement·함수형으로 구분하는 기준, 옵셔널과 기본값 처리, FC 타입을 굳이 쓰지 않는 이유까지 실무 관점으로 다룹니다.

· 8 min read · PALDYN Team
TypeScript 로고
TypeScript

fetch 타이핑 — Response와 unknown 기반 파싱

fetch API를 TypeScript로 안전하게 쓰는 법을 정리합니다. res.json()이 any를 반환하는 함정, 제네릭 단언의 위험, unknown 기반 타입 가드 래퍼, Result와 결합한 에러 처리, AbortController 타이핑까지 실무 관점으로 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

Express 타이핑 — Request 제네릭과 미들웨어

Express를 TypeScript로 타입 안전하게 쓰는 법을 정리합니다. Request의 4개 제네릭(Params, ResBody, ReqBody, Query), RequestHandler 타입, 미들웨어의 타입 전파, req 객체 보강, 비동기 핸들러 에러 처리까지 실무 관점으로 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

HTTP 핸들러 타이핑 — 요청·응답에 타입 입히기

프레임워크에 의존하지 않고 HTTP 핸들러의 요청 본문과 응답을 제네릭으로 타이핑하는 법을 정리합니다. 본문은 unknown으로 받아 검증, 응답은 직렬화 가능한 타입으로 제약, 핸들러 시그니처로 입출력 계약을 고정하는 패턴을 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

fs / path 타이핑 — 파일 시스템 API 안전하게

Node의 fs와 path 모듈을 TypeScript에서 안전하게 쓰는 법을 정리합니다. 인코딩 인자에 따라 Buffer/string으로 갈리는 오버로드, fs/promises 사용, path 결합과 PlatformPath, Dirent·Stats 타입과 에러 코드 좁히기까지 다룹니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

Node.js 코어 타이핑 — @types/node와 내장 모듈

Node.js 런타임을 TypeScript에서 타입 안전하게 쓰기 위한 @types/node의 역할을 정리합니다. 전역 타입 인식, tsconfig의 types·lib 설정, node: 프로토콜 import, Buffer·process·global 같은 내장 객체 타이핑을 다룹니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

환경 변수 타이핑 — process.env 안전하게 다루기

process.env의 string | undefined 함정을 스키마 검증으로 막는 법을 정리합니다. 기본 타입의 한계, ProcessEnv 전역 보강의 위험, Zod 기반 파싱과 형 변환, 앱 시작 시 검증으로 fail-fast 하는 패턴까지 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

의존성 주입 타이핑 — 토큰과 컨테이너 설계

의존성 주입(DI) 컨테이너를 TypeScript로 타입 안전하게 설계합니다. 타입을 실은 InjectionToken, resolve의 타입 추론, 인터페이스 기반 느슨한 결합, 생성자 주입과 팩토리 등록까지 프레임워크 없이 핵심 원리를 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

상태 머신 타이핑 — 불가능한 상태를 제거하기

판별 유니온으로 상태 머신을 타이핑해 "불가능한 상태를 표현 불가능하게" 만드는 법을 다룹니다. 플래그 조합의 모순, 상태별 데이터 결합, 전이 함수 타이핑, exhaustiveness 검사까지 실무 비동기 UI 예제로 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

빌더 패턴 타이핑 — 타입으로 단계 강제하기

객체를 단계적으로 조립하는 빌더 패턴을 TypeScript로 타입 안전하게 구현합니다. 제네릭으로 채워진 키를 추적해 필수 필드 누락을 컴파일 단계에서 막고, this 타입과 메서드 체이닝으로 build() 호출 가능 시점을 제어하는 방법을 다룹니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

Result / Either 타입 — 예외 없는 에러 처리

예외를 던지는 대신 성공과 실패를 값으로 표현하는 Result(Either) 타입을 TypeScript로 설계합니다. 판별 유니온 기반 정의, ok 분기 강제, map·flatMap 같은 콤비네이터, async와의 결합까지 실무 관점에서 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

JSON.parse 타이핑 — unknown 기반 안전한 파싱

JSON.parse가 any를 반환해 생기는 타입 구멍을 unknown 래퍼와 런타임 검증으로 막는 법을 정리합니다. as 단언의 위험, 타입 가드 작성, Zod 같은 스키마 검증, parse 결과를 Result로 감싸는 패턴까지 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

JSON 타이핑 — JSON 값을 안전하게 표현하기

임의의 JSON 값을 표현하는 재귀적 JsonValue 타입을 정의하고, JsonObject·JsonArray 구조, 직렬화 가능한 타입만 허용하는 제약, 그리고 객체 타입이 JSON 호환인지 검증하는 패턴까지 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

Phantom 타입 — 타입으로만 상태를 추적하기

값에는 존재하지 않고 타입 매개변수로만 상태를 표현하는 Phantom 타입을 설명합니다. Connection<open/closed> 상태 머신, 빌더의 필수 단계 강제, 컴파일 타임에 잘못된 호출을 막는 패턴을 예제로 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

Opaque 타입 — 구조적 타이핑에 명목성 부여하기

구조적 타이핑에서 string·number가 무분별하게 호환되는 문제를 brand로 막는 Opaque(branded) 타입을 설명합니다. UserId와 PostId를 구분하는 방법, 생성자 함수, unique symbol 브랜딩, 런타임 비용 0의 안전성을 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

리터럴 유니온 자동완성 — string & {} 패턴

string 리터럴 유니온에 자유 문자열을 허용하면서도 IDE 자동완성을 유지하는 string & {} 패턴을 설명합니다. 왜 단순 union에서는 추천이 사라지는지, LooseAutocomplete 헬퍼와 satisfies 활용까지 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

UnionToIntersection — 유니온을 인터섹션으로 변환하기

TypeScript에서 A | B | C를 A & B & C로 바꾸는 UnionToIntersection 타입을 단계별로 분해합니다. 분배 조건부 타입, 함수 매개변수의 반공변성, infer를 통한 인터섹션 도출 원리와 실전 활용을 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

type-challenges 입문 — 타입 레벨 프로그래밍 연습

type-challenges 저장소로 타입 레벨 프로그래밍을 연습하는 법을 정리합니다. 타입을 함수처럼 다루는 사고방식, MyPick·First·Length 같은 입문 문제 풀이, 그리고 conditional·infer·재귀를 조합하는 패턴까지 소개합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 빌드 성능 최적화 — 컴파일 속도 끌어올리기

TypeScript 컴파일이 느려지는 원인과 해결책을 정리합니다. incremental·skipLibCheck·isolatedModules 옵션, 타입 검사와 트랜스파일 분리, project references, 그리고 tsc --diagnostics로 병목을 찾는 법까지 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

async/await와 Promise 타이핑 — 비동기 코드의 타입

TypeScript에서 Promise<T>의 타입, async 함수의 반환 타입 추론, await 언래핑, Promise.all과 Promise.allSettled의 타이핑까지 비동기 코드를 타입 안전하게 다루는 방법을 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

React 타이핑 시작 — 컴포넌트와 props의 타입

React 컴포넌트와 props에 타입을 입히는 기본을 정리합니다. props 인터페이스 정의, React.FC를 쓰지 않는 이유, children과 ReactNode, 기본값과 옵셔널 props, HTML 속성 확장을 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

typescript-eslint — 타입 인식 린팅 설정하기

typescript-eslint로 TypeScript 코드를 린팅하는 법을 정리합니다. 컴파일러와 린터의 역할 차이, 타입 인식 규칙의 동작 원리, flat config 설정과 projectService, 성능 고려사항을 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

프로젝트 레퍼런스 — 모노레포를 위한 빌드 분할

TypeScript 프로젝트 참조(project references)를 정리합니다. references 선언과 의존 그래프, tsc -b의 빌드 순서 계산, composite 요구사항, 모노레포에서의 효과와 주의점을 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

composite와 incremental — 증분 빌드의 기초

TypeScript의 incremental과 composite 옵션을 정리합니다. .tsbuildinfo로 증분 빌드를 구성하는 법, composite가 켜는 제약, 두 옵션의 관계와 프로젝트 참조로 이어지는 흐름을 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

isolatedModules — 파일 단위 트랜스파일을 위한 제약

isolatedModules 옵션이 무엇을 검사하는지 정리합니다. 전체 프로그램 변환과 파일 단위 변환의 차이, esbuild·swc·Babel과의 관계, 타입 재내보내기·const enum 같은 위반 패턴과 해결법을 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

paths와 baseUrl — 경로 별칭으로 import 정리하기

TypeScript의 baseUrl과 paths로 경로 별칭을 만드는 법을 정리합니다. 상대 경로 지옥 해결, 패턴 매핑 문법, paths가 런타임을 바꾸지 않는다는 함정과 번들러·Node 연동까지 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

strict 모드 플래그 — 엄격함을 구성하는 옵션들

TypeScript의 strict 모드를 구성하는 개별 플래그를 정리합니다. strict가 켜는 플래그 묶음, strictNullChecks와 noImplicitAny의 효과, strict에 포함되지 않는 추가 안전 플래그까지 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

전역 보강 — Window와 전역 스코프 확장하기

모듈 안에서 전역 스코프를 확장하는 declare global을 정리합니다. Window·globalThis 확장, 전역 변수와 함수 선언, interface와 var의 차이, .d.ts 배치와 흔한 실수를 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

모듈 보강 — 남의 라이브러리 타입을 확장하기

선언 병합을 모듈 경계 너머로 확장하는 모듈 보강(module augmentation)을 정리합니다. declare module 문법, import가 필요한 이유, express Request 확장 같은 실전 패턴과 흔한 함정을 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

선언 병합 — 같은 이름의 선언이 만나면

TypeScript 고유의 선언 병합 규칙을 정리합니다. 인터페이스 병합의 동작과 제약, namespace와 함수·클래스·enum의 병합 패턴, Window 확장 같은 실전 사례와 주의점을 다룹니다.

· 8 min read · PALDYN Team
TypeScript 로고
TypeScript

앰비언트 모듈 — 타입 없는 모듈에 타입 입히기

declare module 구문으로 타입이 없는 npm 패키지와 에셋 import에 타입을 부여하는 방법을 다룹니다. 와일드카드 모듈, 본문 없는 축약 선언, vite/client의 정체까지 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

앰비언트 선언 — 컴파일러에게 존재를 알리기

declare 키워드로 런타임에 이미 존재하는 전역 변수·함수·클래스에 타입을 입히는 앰비언트 선언을 다룹니다. 스크립트와 모듈의 전역 스코프 차이, declare global, 흔한 함정을 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

DefinitelyTyped와 @types — 커뮤니티 타입 생태계

타입 없는 JavaScript 라이브러리에 타입을 공급하는 DefinitelyTyped 생태계를 정리합니다. @types 패키지의 동작 원리, 탐색 우선순위, 버전 정책, typeRoots 옵션과 흔한 함정까지 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

선언 파일(.d.ts) — 타입 정보의 배포 형식

타입스크립트 생태계를 지탱하는 .d.ts 선언 파일을 해부합니다. declaration 옵션의 출력물, declare 키워드의 의미, 라이브러리가 타입을 배포하는 구조와 직접 작성하는 방법까지 다룹니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

verbatimModuleSyntax — 모듈 구문을 쓴 그대로

TypeScript 5.0의 verbatimModuleSyntax 옵션을 해부합니다. import elision의 문제, 옵션 하나로 통합된 규칙, CJS 출력에서의 동작, 도입 시 마주치는 에러와 해결법을 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

타입 전용 import/export — import type 완전 정복

import type과 인라인 type 한정자가 왜 필요한지 컴파일 결과로 확인합니다. 타입 제거(erasure)의 원리, isolatedModules와의 관계, 순환 참조 해소 패턴까지 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

Node16/NodeNext 모듈 해석 — ESM 시대의 규칙

moduleResolution: nodenext가 강제하는 규칙들을 해부합니다. 파일별 ESM/CJS 형식 판정, 상대 경로의 .js 확장자 의무, exports 필드 해석, .mts/.cts 확장자까지 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

모듈 해석 — TypeScript가 import를 찾는 방법

import 경로가 실제 파일로 연결되는 모듈 해석 과정을 분해합니다. 상대 경로와 패키지 경로의 탐색 순서, moduleResolution 4가지 전략의 차이와 선택 기준을 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

Deep Readonly 패턴 완전 정복

TypeScript의 Readonly<T>가 얕은(shallow) 불변성만 제공하는 한계를 설명하고, 재귀 Mapped Type으로 구현하는 DeepReadonly<T>를 완전히 정리합니다. Redux 상태 불변성, 설정 객체 보호, DeepPartial, DeepMutable 패턴을 다룹니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

ThisType과 OmitThisParameter 완전 정복

TypeScript의 ThisType<T>와 OmitThisParameter<F>를 깊이 파헤칩니다. 객체 리터럴 메서드에서 this 타입을 제어하는 원리, Vue 2 Options API 구현 패턴, bind 후 this 제거, noImplicitThis 설정과의 관계를 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

InstanceType과 ConstructorParameters 완전 정복

TypeScript의 InstanceType<T>와 ConstructorParameters<T>가 생성자 타입을 분해하는 원리를 설명합니다. 제네릭 팩토리 함수, 의존성 주입 컨테이너, Mixin 패턴, 클래스 레지스트리 구현을 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

NonNullable 유틸리티 타입 완전 정복

TypeScript의 NonNullable<T>가 null과 undefined를 타입에서 제거하는 원리를 설명합니다. strictNullChecks와의 관계, filter(Boolean) 타입 강화 패턴, 제네릭 제약 조건, 재귀 DeepNonNullable 패턴을 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

Awaited 유틸리티 타입 완전 정복

TypeScript 4.5에 도입된 Awaited<T>가 Promise를 재귀적으로 언래핑하는 원리를 설명합니다. async 함수 반환 타입 추출, Promise.all 결과 타입, React Query와의 통합, 고차 비동기 함수 패턴을 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

ReturnType과 Parameters로 함수 타입 분해하기

TypeScript의 ReturnType<F>와 Parameters<F> 유틸리티 타입이 infer 키워드로 함수 타입을 분해하는 원리를 설명합니다. API 반환 타입 재사용, 래퍼 함수 시그니처 보존, memoize·throttle 고차 함수 패턴을 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

Extract와 Exclude로 유니언 조각내기

TypeScript의 Extract<T, U>와 Exclude<T, U>가 분배 조건부 타입으로 유니언을 필터링하는 원리를 설명합니다. NonNullable 구현, 판별 유니언 서브셋 추출, 키 집합 연산 등 실전 패턴을 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

Record 타입 완전 정복

TypeScript의 Record<K, V> 유틸리티 타입을 깊이 파헤칩니다. 인덱스 시그니처와의 차이, 리터럴 유니언 키로 완전한 매핑 강제, groupBy·상태 설정 테이블·폼 에러 맵 등 실전 패턴을 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

Pick과 Omit으로 타입 조각내기

TypeScript의 Pick<T, K>와 Omit<T, K> 유틸리티 타입을 완전히 이해합니다. 화이트리스트/블랙리스트 전략 선택법, API 응답 분리, CRUD 폼 타입 파생, 컴포넌트 Props 설계까지 실전 패턴을 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

Partial · Required · Readonly 완전 정복

TypeScript 3대 객체 변환 유틸리티 타입을 깊이 파헤칩니다. Partial로 부분 업데이트를 안전하게, Required로 검증 완료 타입을 명시하고, Readonly로 불변 객체를 선언하는 방법과 내부 Mapped Type 구현 원리를 설명합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

유틸리티 타입 총정리 — Partial에서 Awaited까지

TypeScript 내장 유틸리티 타입 전체를 용도별로 분류해 정리합니다. 객체 변환(Partial·Required·Readonly·Pick·Omit·Record), 유니언 조작(Extract·Exclude·NonNullable), 함수 분해(ReturnType·Parameters·Awaited), 추론 제어(NoInfer)까지 완전 정복.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

재귀 타입 — 자기 자신을 참조하는 타입 구조

TypeScript 재귀 타입(Recursive Types)의 선언 방법, 지연 평가와 즉시 평가 차이, DeepReadonly·DeepPartial·JSON 타입 구현, 재귀 깊이 제한과 우회 패턴을 완전히 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

매핑된 타입 수정자 — +/-와 as 키 재매핑

TypeScript 매핑된 타입의 +/- 수정자로 readonly·optional을 추가/제거하는 방법, as 절로 키 이름 변환·필터링하는 패턴을 완전히 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

NoInfer 유틸리티 — 제네릭 추론 사이트 제어

TypeScript 5.4에서 도입된 NoInfer<T> 유틸리티 타입의 동작 원리, T 추론 제어, 실전 패턴(초기값 설정, 이벤트 핸들러, 배열 기본값)을 완전히 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

제네릭 함수 — 타입 안전한 재사용

TypeScript 제네릭 함수의 타입 파라미터 선언, 타입 추론, 다중 타입 파라미터, 제약 조건(extends), 화살표 함수 제네릭을 실무 예시와 함께 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

정적 멤버 — 클래스 레벨의 공유 상태

TypeScript static 키워드로 선언하는 정적 프로퍼티·메서드의 동작 원리, 인스턴스 멤버와의 차이, 싱글턴·팩토리 패턴 활용, static 블록을 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

게터와 세터 — 프로퍼티 접근 제어

TypeScript get/set 접근자의 동작 원리, 유효성 검사 패턴, 계산된 프로퍼티, 인터페이스와의 관계, 주의사항을 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

파라미터 프로퍼티 — 생성자 단축 선언

TypeScript 파라미터 프로퍼티 문법으로 클래스 선언을 줄이는 방법, public/private/readonly 조합, 주의사항과 실무 가이드를 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

클래스 상속 — extends와 super 완전 정리

TypeScript 클래스 상속 문법, super() 생성자 호출 규칙, override 키워드, 다형성 활용, instanceof 타입 가드를 실무 예시와 함께 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

추상 클래스 — 설계도와 구현 분리

TypeScript abstract class의 선언 방식, 추상 메서드 강제 구현, 인터페이스와의 차이, 템플릿 메서드 패턴 실무 예시를 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

인덱스 접근 타입 — T[K]로 타입 추출

TypeScript 인덱스 접근 타입(Indexed Access Types) T[K] 문법, 중첩 접근, 배열 요소 타입 추출, API 응답 타입 DRY 패턴을 완전히 정리합니다.

· 3 min read · PALDYN Team
TypeScript 로고
TypeScript

keyof와 typeof — 타입에서 키를 추출하다

TypeScript keyof 연산자로 타입의 키 유니언 추출, typeof 연산자로 값에서 타입 추론, 두 연산자 조합 패턴을 완전히 정리합니다.

· 3 min read · PALDYN Team
TypeScript 로고
TypeScript

인덱스 시그니처 — 동적 키 타입 처리

TypeScript 인덱스 시그니처(Index Signature)의 string·number 인덱스, Record 유틸리티, 혼합 시그니처, 한계와 대안을 완전히 정리합니다.

· 4 min read · PALDYN Team
TypeScript 로고
TypeScript

interface extends — 계층적 타입 설계

TypeScript interface extends로 단일·다중 상속, 충돌 감지, 클래스 implements까지 계층적 타입 설계를 완전히 정리합니다.

· 4 min read · PALDYN Team
TypeScript 로고
TypeScript

리터럴 타입 — 정확한 값으로 타입 좁히기

TypeScript 리터럴 타입(문자열·숫자·불리언)의 선언 방법, 타입 확장(widening), as const를 통한 리터럴 고정, 유니언과의 조합 패턴을 완전히 정리합니다.

· 11 min read · PALDYN Team
TypeScript 로고
TypeScript

타입 공간과 값 공간 — TypeScript의 두 세계

TypeScript 코드에는 타입 공간과 값 공간이 공존합니다. 이 구분을 이해하면 컴파일 오류와 런타임 동작의 차이를 명확히 파악할 수 있습니다. typeof, class, enum의 이중 역할도 함께 설명합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 에디터 환경 최적화 — VS Code 완전 설정

VS Code에서 TypeScript 개발 생산성을 극대화하는 설정을 안내합니다. 필수 확장 설치, settings.json 최적화, 단축키, 프로젝트별 TypeScript 버전 관리까지 다룹니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 특수 타입: any, unknown, never, void 완전 정복

TypeScript의 4가지 특수 타입(any, unknown, never, void)의 의미와 차이를 완전히 이해합니다. 각 타입을 언제 쓰고 언제 피해야 하는지, 타입 계층에서의 위치와 실전 사용 패턴을 다룹니다.

· 9 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 원시 타입 완전 정복: string, number, boolean 외 4종

TypeScript의 7가지 원시 타입(string, number, boolean, bigint, symbol, null, undefined)을 완전히 정리합니다. 소문자 vs 대문자 타입 주의사항, strictNullChecks 동작, 원시 타입별 유용한 패턴을 다룹니다.

· 8 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript Playground: 설치 없이 브라우저에서 실험하기

TypeScript Playground의 핵심 기능 6가지를 완전히 파악합니다. 실시간 타입 검사, JS 출력 확인, 컴파일러 옵션 조정, URL 공유 기능을 활용해 TypeScript 학습과 디버깅을 가속화하세요.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 개발 환경 설치: Node.js부터 tsconfig까지

Node.js 설치부터 TypeScript 전역 설치, 프로젝트 초기화, tsconfig.json 핵심 옵션 설정까지 단계별로 안내합니다. VS Code 연동과 ts-node를 이용한 빠른 실행 방법도 다룹니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript vs JavaScript: 코드로 보는 결정적 차이

TypeScript와 JavaScript의 차이를 7가지 관점에서 실제 코드와 함께 비교합니다. 언제 TypeScript가 빛을 발하고, 언제 JavaScript로 충분한지 판단 기준을 제시합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

왜 TypeScript인가? 현업에서의 실제 가치

TypeScript를 도입해야 하는 5가지 이유, 런타임 오류와 컴파일 타임 오류의 차이, 그리고 실제 프로젝트에서 TypeScript가 버그를 막은 사례를 살펴봅니다.

· 8 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 점진적 도입 — JS 프로젝트에서 TS로

기존 JavaScript 코드베이스에 TypeScript를 점진적으로 도입하는 전략, allowJs·checkJs 설정, JSDoc 타입 주석, ts-migrate 자동화, CI 통합까지 완전히 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

tsconfig 완전 정복 — 컴파일러 옵션 가이드

TypeScript tsconfig.json의 target, module, moduleResolution, strict 계열 옵션, 경로 설정, 프로젝트 참조까지 실무에서 자주 쓰는 옵션을 완전히 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

데코레이터 — 클래스와 멤버에 메타데이터 주입

TypeScript 데코레이터의 종류(클래스·메서드·속성·매개변수), 실행 순서, 데코레이터 팩토리, 로깅·캐시·DI 실전 패턴, Stage 3 표준과 레거시 API 차이를 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

판별 유니언 — 타입 안전한 상태 모델링

TypeScript 판별 유니언(Discriminated Union)의 구조, 판별자 조건, switch 완전성 검사, 액션 패턴, 상태 머신 모델링까지 완전히 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

타입 가드 — 런타임 타입 좁히기 기법

TypeScript 타입 가드의 모든 방법(typeof, instanceof, in, 사용자 정의 타입 술어, 단언 함수)과 제어 흐름 분석을 통한 자동 타입 좁히기를 완전히 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

unknown · never · any — 타입 계층의 끝점들

TypeScript의 unknown(top type), never(bottom type), any(탈출구) 세 가지 특수 타입의 차이, 올바른 사용 시나리오, 완전성 검사 패턴을 완전히 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

infer 키워드 — 조건부 타입 내 타입 추론

TypeScript infer 키워드의 동작 원리, ReturnType·Parameters·Awaited 내장 구현, 튜플 분해, 재귀 패턴, TS 4.7 infer 제약 추가까지 완전히 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

조건부 타입 — 타입 수준의 분기 처리

TypeScript 조건부 타입(T extends U ? A : B), infer 키워드, 분배 조건부 타입, NonNullable·Extract·Exclude 내장 유틸리티 구현 원리를 완전히 정리합니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

제네릭 제약 — extends와 keyof

TypeScript 제네릭의 extends 제약, keyof 연산자, 인덱스 접근 타입 T[K], 생성자 제약, 재귀 제약을 예제 중심으로 완전히 정리합니다. 과도한 제약이 오히려 유연성을 해치는 경우도 다룹니다.

· 5 min read · PALDYN Team
TypeScript 로고
TypeScript

제네릭 기초 — 재사용 가능한 타입 추상화

TypeScript 제네릭의 핵심 개념, 함수·인터페이스·클래스의 제네릭 선언, 타입 매개변수 추론, 기본값 설정, 다중 타입 매개변수 활용을 예제 중심으로 완전히 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

interface vs type — 차이와 선택 기준

TypeScript의 interface와 type alias 차이를 선언 병합, 확장 방식, 표현 가능 범위 관점에서 완전히 정리합니다. 언제 interface를 쓰고 언제 type을 써야 하는지 실용적 기준을 제시합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

유니언·인터섹션·리터럴 타입

TypeScript의 유니언 타입(A|B), 인터섹션 타입(A&B), 리터럴 타입, 판별 유니언 패턴, 템플릿 리터럴 타입을 예제 중심으로 완전히 정리합니다.

· 6 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 기본 타입 완전 정복

TypeScript의 원시 타입, 특수 타입(any·unknown·never·void), 배열·튜플·열거형, 타입 좁히기(narrowing), 타입 단언과 const 단언을 예제 중심으로 완전히 정리합니다.

· 7 min read · PALDYN Team
TypeScript 로고
TypeScript

TypeScript 핵심 · 왜 타입이 필요한가

TypeScript의 존재 이유, 구조적 타이핑 원칙, 컴파일 파이프라인, 타입 추론 메커니즘, tsconfig 핵심 옵션을 완전히 정리합니다. JavaScript와의 관계와 TypeScript를 도입해야 하는 실질적 이유를 다룹니다.

· 7 min read · PALDYN Team