majiayu000 PF 의존성 검사
$ARGUMENTS 의존성을 검사하고 업데이트를 제안합니다.
검사 항목
1. Catalog 버전 확인
# pnpm-workspace.yaml의 catalog 확인
cat pnpm-workspace.yaml | grep -A 50 "catalog:"
2. 업데이트 가능한 패키지
# 전체 업데이트 확인
pnpm outdated
# 특정 패키지만
pnpm outdated react
3. 보안 취약점
pnpm audit
4. 중복 패키지
pnpm why react
pnpm dedupe --check
주요 패키지 업데이트 가이드
React 업데이트
# pnpm-workspace.yaml
catalog:
react: ^19.2.0 # 현재
react-dom: ^19.2.0
@types/react: ^19.0.0
@types/react-dom: ^19.0.0
주의사항:
- React 19는 forwardRef 불필요
- 새 Hooks (use, useOptimistic 등) 사용 가능
- React Compiler 호환성 확인
Vite 업데이트
catalog:
vite: ^7.3.0
@vitejs/plugin-react: ^4.5.0
주의사항:
- vite.config.ts 변경사항 확인
- 플러그인 호환성 확인
TypeScript 업데이트
catalog:
typescript: ^5.9.0
주의사항:
- tsconfig.json 새 옵션 확인
- 타입 에러 발생 가능성
Tailwind CSS 업데이트
catalog:
tailwindcss: ^4.1.0
주의사항:
- v4는 설정 방식 변경됨
- postcss 설정 확인
업데이트 절차
1. Minor/Patch 업데이트 (안전)
# catalog 수정 후
pnpm install
pnpm build
pnpm test
2. Major 업데이트 (주의)
# 1. 변경사항 확인
# 공식 마이그레이션 가이드 읽기
# 2. 별도 브랜치에서 진행
git checkout -b chore/upgrade-react-19
# 3. catalog 수정
# pnpm-workspace.yaml 편집
# 4. 의존성 설치
pnpm install
# 5. 빌드 테스트
pnpm build
# 6. 타입 에러 수정
# 7. 런타임 테스트
pnpm dev
# 8. PR 생성
버전 범위 규칙
# pnpm-workspace.yaml
catalog:
# ^ (caret) - minor 업데이트 허용 (권장)
react: ^19.2.0 # 19.2.0 ~ 19.x.x
# ~ (tilde) - patch만 허용 (안정성 중시)
cesium: ~1.120.0 # 1.120.0 ~ 1.120.x
# 정확한 버전 (외부 라이브러리)
three: 0.170.0 # 정확히 0.170.0
의존성 충돌 해결
피어 의존성 충돌
# 경고 확인
pnpm install
# 강제 해결 (.npmrc)
auto-install-peers=true
resolve-peers-from-workspace-root=true
버전 불일치
# 어디서 사용되는지 확인
pnpm why 패키지명
# 특정 버전 강제 (pnpm-workspace.yaml)
pnpm:
overrides:
패키지명: ^1.0.0
정기 점검 체크리스트
-
pnpm outdated실행 -
pnpm audit보안 취약점 확인 - Major 업데이트 마이그레이션 가이드 확인
- CI/CD에서 빌드 성공 확인
- 주요 기능 수동 테스트
Context7 참고
패키지 마이그레이션 가이드가 필요하면 Context7로 최신 문서를 조회하세요.