# pnpm-workspace.yaml (레포 루트 영역에 생성)
# 💡 이 파일 하나가 "여기서부터 모노레포야!" 라고 선언하는 호적등본 같은 역할을 합니다.
packages:
  # 🦁 apps 폴더 밑에 있는 모든 폴더를 하나의 개별 프로젝트(Workspace 패키지)로 취급합니다.
  # 예: apps/community, apps/admin 등
  - 'apps/*'
  
  # 🦁 packages 폴더 밑에 있는 것들도 동일하게 개별 패키지로 취급합니다.
  # 예: packages/ui, packages/types 등
  - 'packages/*'
  
  # 만약 하위 폴더가 더 깊게 있다면 ** (글로브) 패턴을 쓸 수도 있습니다.
  - 'packages/**'
  
  # 💡 느낌표(!)를 붙이면 특정 폴더를 모노레포 대상에서 제외시킬 수 있습니다.
  # 테스트 폴더나 캐시 폴더는 패키지가 아니니까 제외해줍니다.
  - '!**/test/**'
  - '!**/.cache/**'

// packages/ui/package.json
{
  "name": "@youngsu/ui",
  "version": "1.0.0",
  "main": "./src/index.ts",
  "exports": {
    ".": "./src/index.ts"
  }
}

// packages/types/package.json
{
  "name": "@youngsu/types",
  "version": "1.0.0",
  "main": "./src/index.ts",
  "types": "./src/index.ts"
}

// apps/community/package.json
{
  "name": "@youngsu/community",
  "dependencies": {
    "@youngsu/ui": "workspace:*",
    "@youngsu/types": "workspace:*"
  }
}

{
  "dependencies": {
    "@youngsu/ui": "workspace:*",       // 현재 로컬 버전 그대로 사용
    "@youngsu/types": "workspace:^",    // SemVer ^ 범위로 로컬 참조
    "@youngsu/config": "workspace:~"    // SemVer ~ 범위로 로컬 참조
  }
}

// 배포 전 (로컬)
{ "@youngsu/ui": "workspace:*" }
 
// 배포 후 (실제 npm 패키지)
{ "@youngsu/ui": "^1.0.0" }  // 현재 @youngsu/ui 버전이 1.0.0 이면

# @youngsu/community 에 @youngsu/ui 의존성 추가
pnpm --filter @youngsu/community add @youngsu/ui
 
# pnpm 이 자동으로 workspace: 프로토콜을 감지해서 로컬 연결

# 정확한 패키지명
pnpm --filter @youngsu/ui build
 
# 스코프 전체
pnpm --filter "@youngsu/*" build
 
# 이름 패턴 (와일드카드)
pnpm --filter "*community*" dev
 
# 단축형 -F
pnpm -F @youngsu/ui build

# @youngsu/ui 와 @youngsu/ui 가 의존하는 패키지들 모두
pnpm --filter "@youngsu/ui..." build
 
# @youngsu/ui 에 의존하는 모든 패키지들 (community, admin 등)
pnpm --filter "...@youngsu/ui" build
 
# @youngsu/ui 의 직접 의존성만 (ui 자신 제외)
pnpm --filter "@youngsu/ui^..." build

# main 브랜치 대비 변경된 패키지만 빌드
pnpm --filter "[origin/main]" build
 
# main 대비 변경된 패키지 + 그에 의존하는 패키지 모두
pnpm --filter "...[origin/main]" build
 
# apps/ 디렉토리 내 변경된 패키지만
pnpm --filter "{apps/**}[origin/main]" build

# apps/ 하위 모든 패키지
pnpm --filter "./apps/**" dev
 
# 현재 디렉토리 기준 (cd apps/community 후)
pnpm --filter "." dev

# 모든 패키지 설치
pnpm -r install
 
# 모든 패키지 빌드 (의존성 순서대로)
pnpm -r build
 
# 모든 패키지 테스트
pnpm -r test
 
# 모든 패키지 lint
pnpm -r lint
 
# 특정 script 가 있는 패키지에만 실행
pnpm -r --if-present test

# 기본: 의존성 그래프 순서로 실행 (순차)
pnpm -r build
 
# 강제 병렬 실행 (의존성 무시 - 주의)
pnpm -r --parallel build
 
# 동시 실행 수 제한
pnpm -r --workspace-concurrency=3 build

# 루트 package.json 의 스크립트도 포함해서 실행
pnpm -r --include-workspace-root build

# pnpm-workspace.yaml
packages:
  - 'apps/*'
  - 'packages/*'

// package.json (모노레포 루트 - 최상단)
// 💡 루트 패키지는 자체적으로 배포할 앱이 아니라, 모노레포 전체를 묶어주는 껍데기 역할입니다.
{
  "name": "youngsu-monorepo",
  "private": true, // 🦁 [중요] 루트 자체를 npm에 잘못 배포하는 실수를 막아줍니다.
  "packageManager": "pnpm@9.15.0",
  "engines": {
    "node": ">=20.0.0",
    "pnpm": ">=9.0.0"
  },
  "scripts": {
    // 🦁 [핵심] '-r' 옵션은 'recursive(재귀)'의 약자로, 하위의 모든 패키지를 돌면서 명령어를 실행하라는 뜻입니다.
    
    // 💡 전체 빌드: main 브랜치 기준으로 "변경된 소스"가 있는 패키지와 그에 영향을 받는 패키지만 추려서 빌드합니다. (캐싱 극대화)
    "build": "pnpm -r --filter \"[origin/main]...\" build",
    
    // 💡 전체 개발모드 켜기: --parallel 옵션을 주면 admin과 community 앱 모두 동시에 실행창이 뜹니다.
    "dev": "pnpm -r --parallel --filter \"./apps/**\" dev",
    
    // 타입 검사: 모든 패키지에 대해 순서대로 진행
    "typecheck": "pnpm -r typecheck",
    
    // 테스트: 변경된 패키지만 똑똑하게 골라서 테스트
    "test": "pnpm --filter \"...[origin/main]\" test",
    
    // 💡 --if-present 옵션: 하위 패키지 중에 "lint" 스크립트가 적혀있는 곳에서만 알아서 실행하고, 없으면 무시합니다.
    "lint": "pnpm -r --if-present lint"
  },
  "devDependencies": {
    // 🦁 전체 앱에서 공통으로 쓰는 도구(타입스크립트, ESLint 등)는 루트에 한 번만 깝니다.
    // 각 앱마다 반복해서 깔 필요가 없이 pnpm이 알아서 다 연결해줍니다.
    "typescript": "^5.3.3",
    "@types/node": "^20.11.0",
    "eslint": "^8.57.0",
    "prettier": "^3.2.5"
  }
}

// apps/community/package.json
{
  "name": "@youngsu/community",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "typecheck": "tsc --noEmit",
    "lint": "next lint"
  },
  "dependencies": {
    "next": "^14.2.0",
    "react": "^18.2.0",
    "react-dom": "^18.2.0",
    
    // 🦁 [초핵심] 모노레포 내부 패키지 연결의 마법!
    // NPM 원격 저장소가 아니라, 우리 로컬 폴더(packages/ui)에 있는 코드를 바로 가져다 씁니다.
    // "workspace:*" 는 항상 로컬의 최신 코드를 바라보겠다는 뜻입니다. (심링크 효과)
    "@youngsu/ui": "workspace:*",
    "@youngsu/types": "workspace:*"
  },
  "devDependencies": {
    // 공통 설정파일(packages/config)도 동일하게 workspace 프로토콜로 당겨옵니다.
    "@youngsu/config": "workspace:*"
  }
}

// packages/ui/package.json
{
  "name": "@youngsu/ui",
  "version": "1.0.0",
  "exports": {
    ".": {
      "import": "./src/index.ts",
      "types": "./src/index.ts"
    },
    "./button": "./src/components/Button.tsx",
    "./card": "./src/components/Card.tsx"
  },
  "scripts": {
    "typecheck": "tsc --noEmit",
    "lint": "eslint src/"
  },
  "devDependencies": {
    "react": "^18.2.0",
    "@types/react": "^18.2.0"
  },
  "peerDependencies": {
    "react": "^18.2.0"
  }
}

// packages/config/tsconfig.base.json
{
  "compilerOptions": {
    "target": "ES2022",
    "lib": ["dom", "dom.iterable", "esnext"],
    "allowJs": true,
    "skipLibCheck": true,
    "strict": true,
    "noEmit": true,
    "esModuleInterop": true,
    "moduleResolution": "bundler",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
    "incremental": true,
    "baseUrl": "."
  }
}

// apps/community/tsconfig.json — 공통 설정 확장
{
  "extends": "@youngsu/config/tsconfig.base.json",
  "compilerOptions": {
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
  "exclude": ["node_modules"]
}

# 전체 설치
pnpm install
 
# community 앱만 개발 서버 실행
pnpm --filter @youngsu/community dev
 
# UI 패키지 변경 후 타입 체크
pnpm --filter "@youngsu/ui..." typecheck
 
# community 에 새 패키지 추가
pnpm --filter @youngsu/community add axios
 
# 루트 devDep 추가
pnpm add -D -w eslint-plugin-tailwindcss
# -w: --workspace-root (루트 package.json 에 추가)
 
# 변경된 패키지와 영향받는 앱만 빌드 (CI 최적화)
pnpm --filter "...[origin/main]" build