// apps/community/package.json
{ "react": "^18.2.0" }
 
// apps/admin/package.json
{ "react": "^18.2.1" }   ← 누군가 업데이트함
 
// apps/landing/package.json
{ "react": "^18.1.0" }   ← 오래된 버전

# pnpm-workspace.yaml
# 💡 이 공간이 모노레포 전체의 "단일 진실 공급원(Single Source of Truth)"이 됩니다.
packages:
  - 'apps/*'
  - 'packages/*'
 
# 🦁 catalog: (단수형) → 모노레포 전체에서 공통으로 쓸 "기본 카탈로그"를 정의합니다.
catalog:
  # 아래 적힌 패키지들은 이제부터 이 버전으로 전체 통일됩니다!
  react: ^18.2.0
  react-dom: ^18.2.0
  next: ^14.2.0
  typescript: ^5.3.3
  "@types/react": ^18.2.0
  "@types/node": ^20.11.0
  tailwindcss: ^3.4.1
  axios: ^1.6.7
  zod: ^3.22.4
  "@tanstack/react-query": ^5.17.15
  prisma: ^5.9.1
  "@prisma/client": ^5.9.1

// apps/community/package.json
{
  "name": "@youngsu/community",
  "dependencies": {
    // 🦁 [핵심] 버전을 ^18.2.0 이라고 직접 쓰지 않고 "catalog:" 라고만 적습니다.
    // 이렇게 하면 pnpm 이 알아서 pnpm-workspace.yaml 에 선언된 버전을 당겨옵니다.
    "next": "catalog:",
    "react": "catalog:",
    "react-dom": "catalog:",
    "axios": "catalog:",
    "@tanstack/react-query": "catalog:",
    
    // 💡 우리 모노레포 내부의 다른 패키지를 쓸 때는 workspace:* 를 씁니다.
    // (외부 라이브러리 = catalog: / 내부 라이브러리 = workspace: 로 완벽하게 분리!)
    "@youngsu/ui": "workspace:*"
  },
  "devDependencies": {
    "typescript": "catalog:",
    "@types/react": "catalog:",
    "@types/node": "catalog:",
    "tailwindcss": "catalog:"
  }
}

// apps/admin/package.json
{
  "name": "@youngsu/admin",
  "dependencies": {
    "next": "catalog:",     // community 와 완전히 동일한 버전 보장
    "react": "catalog:",
    "react-dom": "catalog:"
  }
}

# pnpm-workspace.yaml 에서 한 줄만 수정
catalog:
  react: ^18.3.0   # ← 이 한 줄이 모든 앱에 자동 적용

pnpm install
# → lock 파일 업데이트, 모든 앱에서 react@18.3.x 사용

{
  "dependencies": {
    "react": "catalog:",           // default catalog 의 react
    "react": "catalog:default"     // 명시적으로 default 지정 (동일)
  }
}

// 배포 전
{ "react": "catalog:" }
 
// 배포 후 (pnpm publish 또는 pnpm pack)
{ "react": "^18.2.0" }   // 실제 버전으로 변환됨

# pnpm-workspace.yaml
packages:
  - 'apps/*'
  - 'packages/*'
 
catalog:
  # 기본 (최신)
  react: ^18.2.0
  react-dom: ^18.2.0
 
catalogs:
  # 레거시 앱용 (React 17)
  react17:
    react: ^17.0.2
    react-dom: ^17.0.2
    "@types/react": ^17.0.0
 
  # 최신 실험용 (React 19)
  react19:
    react: ^19.0.0
    react-dom: ^19.0.0
    "@types/react": ^19.0.0
 
  # 공통 도구 버전 (버전 분리 관리)
  dev:
    typescript: ^5.3.3
    eslint: ^8.57.0
    prettier: ^3.2.5

// apps/legacy/package.json (React 17 레거시 앱)
{
  "dependencies": {
    "react": "catalog:react17",
    "react-dom": "catalog:react17"
  }
}

// apps/community/package.json (기본 React 18)
{
  "dependencies": {
    "react": "catalog:",          // default catalog
    "react-dom": "catalog:"
  },
  "devDependencies": {
    "typescript": "catalog:dev"   // dev catalog
  }
}

# codemod 를 사용해서 자동 마이그레이션
pnpm dlx codemod pnpm/catalog

// .pnpmfile.mjs (모노레포 루트)
// 💡 이 파일은 pnpm 이 `pnpm install` 을 실행할 때 중간에 개입(가로채기)할 수 있게 해주는 마법의 훅(Hook) 파일입니다.
export const hooks = {
  // 🦁 [1단계] readPackage 훅: pnpm 이 특정 패키지의 package.json 을 막 읽어들인 순간에 호출됩니다.
  // 여기서 우리가 강제로 package.json 의 내용을 조작해서 반환할 수 있습니다!
  readPackage(pkg, context) {
    // pkg.dependencies 등 수정 로직...
    return pkg; // 수정된 패키지 정보를 pnpm 에게 다시 돌려줌
  },
 
  // 🦁 [2단계] afterAllResolved 훅: 모든 의존성 계산이 끝난 직후 lock 파일을 최종 생성하기 전에 호출.
  afterAllResolved(lockfile, context) {
    return lockfile;
  }
};

// .pnpmfile.mjs
export const hooks = {
  readPackage(pkg, context) {
    // 🐣 영철이 발견한 문제:
    // 'some-old-package' 라는 라이브러리가 "나는 무조건 react 16 버전에서만 돌아!"(peerDependencies) 라고 우기고 있습니다.
    // 하지만 우리는 react 18을 쓰고 있어서, 모니터에 매번 보기 싫은 노란색 경고(Warning)가 뜹니다.
 
    if (pkg.name === 'some-old-package') {
      // 🦁 영호 리드의 해결책:
      // pnpm 이 이 라이브러리를 설치하기 직전에, 우리가 몰래 package.json 안의 요구 조건을 수정해버립니다!
      pkg.peerDependencies = {
        ...pkg.peerDependencies,
        react: '>=16.0.0'   // "16 이상이면 다 호환된다고 쳐라~" 하고 조건을 완화시켰음
      };
      // 터미널에 로그도 남겨서 훗날 디버깅하기 좋게 만듭니다.
      context.log('some-old-package 의 react peerDep 범위를 강제로 완화했습니다.');
    }
 
    return pkg;
  }
};

// .pnpmfile.mjs
export const hooks = {
  readPackage(pkg, context) {
    // 🦁 영호 리드의 실제 사례:
    // 특정 패키지가 취약한 버전의 axios 를 deps 로 고정하고 있음
    // overrides 로 해결할 수도 있지만, 조건부 처리가 필요할 때 pnpmfile 이 유용
 
    if (pkg.dependencies && pkg.dependencies['axios']) {
      const currentVersion = pkg.dependencies['axios'];
      // 0.x.x 버전은 모두 최신 안전 버전으로 교체
      if (currentVersion.startsWith('0.')) {
        pkg.dependencies['axios'] = '^1.6.7';
        context.log(`${pkg.name}: axios ${currentVersion} → ^1.6.7 로 강제 변경`);
      }
    }
 
    return pkg;
  }
};

// .pnpmfile.mjs
export const hooks = {
  readPackage(pkg, context) {
    // 특정 패키지의 불필요한 빌드 도구 제거 (설치 속도 향상)
    if (pkg.name === 'some-heavy-package') {
      delete pkg.devDependencies['webpack'];
      delete pkg.devDependencies['babel-loader'];
    }
 
    return pkg;
  }
};

# overrides 로 해결 가능한 케이스 (더 단순)
# pnpm-workspace.yaml
overrides:
  axios: ^1.6.7
  semver: ^7.5.4

# 중복 확인
pnpm dedupe --check
 
# 실제 중복 제거 (lock 파일 업데이트)
pnpm dedupe

// package.json
{
  "scripts": {
    "preinstall": "npx only-allow pnpm"
  }
}

# npm install 시도하면
npm install
 
# 에러:
# Use "pnpm install" for installing dependencies in this project.
# If you don't have pnpm, install it via "npm i -g pnpm".
# For more details, go to https://pnpm.js.org/

// package.json
{
  "packageManager": "pnpm@9.15.0"
}

# Corepack 활성화 시 자동으로 지정된 버전만 허용
corepack enable
# 이후 yarn install 시도하면 자동으로 에러