pnpm Workspace 의존성 문제

pnpm install

 ERR_PNPM_PEER_DEP_ISSUES  Unmet peer dependencies

.
└─┬ @types/react 19.2.7
  └── ✕ missing peer prop-types@^15.0.0

Peer dependencies that should be installed:
  prop-types@^15.8.1

pnpm add -D prop-types

auto-install-peers=true

{
  "pnpm": {
    "overrides": {
      "prop-types": "^15.8.1"
    }
  }
}

 ERR_PNPM_WORKSPACE_PKG_NOT_FOUND

In sonamu: "workspace:*" is in the dependencies but no package
named "sonamu" is present in the workspace

packages:
  - examples/**/*
  - modules/**/*
  - "!modules/create-sonamu/template/**/*"

# workspace 내 모든 패키지 확인
pnpm ls -r --depth -1

{
  "dependencies": {
    "sonamu": "workspace:*" // workspace에 sonamu 패키지 있어야 함
  }
}

 ERR_PNPM_CATALOG_VERSION_MISMATCH

Package "react" has version "19.2.3" in catalog but "18.3.0"
in package.json

{
  "dependencies": {
    "react": "catalog:" // pnpm-workspace.yaml의 버전 사용
  }
}

catalog:
  react: ^19.2.3 # package.json에 맞춰 업데이트

# 모든 패키지의 의존성을 catalog 버전으로 업데이트
pnpm update -r

Error: Cannot find module '@types/node'
Require stack:
- /path/to/your/project/src/index.ts

public-hoist-pattern[]=@types/*
public-hoist-pattern[]=eslint-*

shamefully-hoist=true

{
  "devDependencies": {
    "@types/node": "catalog:"
  }
}

import { UserModel } from "@/application/user/user.model";
// Error: Cannot find module '@/application/user/user.model'

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}

{
  "ts-node": {
    "require": ["tsconfig-paths/register"]
  }
}

pnpm add -D tsconfig-paths

import _ from "lodash-es"; // package.json에 없음

pnpm add lodash-es

# Phantom dependencies 검사
pnpm ls --depth=Infinity

# 사용하지 않는 의존성 확인
pnpm why <package-name>

 ERR_PNPM_CANNOT_RESOLVE_OPTIONAL_DEPENDENCY

Could not resolve optional dependency @parcel/watcher

onlyBuiltDependencies:
  - "@parcel/watcher"
  - bcrypt
  - esbuild
  - sharp

# 재설치 시도
pnpm install --force

# 또는 특정 패키지만
pnpm add sharp --force

{
  "pnpm": {
    "overrides": {
      "axios": ">=1.0.0"
    }
  }
}

{
  "pnpm": {
    "overrides": {
      "axios@<1.0.0": ">=1.0.0",
      "lodash": "^4.17.21"
    }
  }
}

overrides:
  axios@<0.30.0: ">=0.30.0"
  axios@>=0.8.1 <0.28.0: ">=0.28.0"

# lockfile 재생성
pnpm install --force

# 버전 확인
pnpm why axios

 ERR_PNPM_WORKSPACE_CYCLE

There is a circular dependency in the workspace:
  @sonamu-kit/react-sui -> @sonamu-kit/ui -> @sonamu-kit/react-sui

// @sonamu-kit/react-sui/package.json
{
  "dependencies": {
    "@sonamu-kit/ui": "workspace:*"  // ❌ react-sui가 ui에 의존
  }
}

// @sonamu-kit/ui/package.json
{
  "dependencies": {
    "@sonamu-kit/react-sui": "workspace:*"  // ❌ ui가 react-sui에 의존
  }
}

// 공통 의존성을 별도 패키지로 분리
// @sonamu-kit/common 생성 후 둘 다 참조

{
  "peerDependencies": {
    "@sonamu-kit/ui": "workspace:*"
  }
}

# store 검증
pnpm store prune

# 완전 정리
pnpm store prune --force

# node_modules 삭제
rm -rf node_modules

# lockfile 유지한 채 재설치
pnpm install --frozen-lockfile

# 또는 완전 새로 설치
rm pnpm-lock.yaml
pnpm install