PF 새 패키지 생성 가이드

$ARGUMENTS 새로운 공유 패키지를 생성합니다.

---

패키지 구조

packages/
├── ui/           # UI 컴포넌트
├── api/          # API 클라이언트
├── services/     # 공통 서비스
├── map/          # CesiumJS 지도
├── three/        # Three.js 3D
├── cctv/         # 영상 스트리밍
└── [new-pkg]/    # 새 패키지

---

1단계: 폴더 구조 생성

mkdir -p packages/새패키지/src
cd packages/새패키지

기본 구조

packages/새패키지/
├── src/
│   ├── index.ts          # 진입점 (exports)
│   ├── components/       # 컴포넌트 (있다면)
│   ├── hooks/            # 훅
│   ├── stores/           # Zustand 스토어
│   ├── utils/            # 유틸리티
│   └── types/            # 타입 정의
│       └── index.ts
├── package.json
├── tsconfig.json
├── vite.config.ts        # 빌드 설정
└── README.md

---

2단계: package.json 생성

{
  "name": "@pf-dev/새패키지",
  "version": "0.1.0",
  "type": "module",
  "main": "./dist/index.js",
  "module": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "import": "./dist/index.js",
      "types": "./dist/index.d.ts"
    }
  },
  "files": ["dist"],
  "scripts": {
    "dev": "vite build --watch",
    "build": "vite build && tsc --emitDeclarationOnly",
    "lint": "eslint src --ext .ts,.tsx",
    "clean": "rimraf dist"
  },
  "peerDependencies": {
    "react": "catalog:",
    "react-dom": "catalog:"
  },
  "devDependencies": {
    "@pf-dev/eslint-config": "workspace:*",
    "@pf-dev/typescript-config": "workspace:*",
    "typescript": "catalog:",
    "vite": "catalog:"
  }
}

---

3단계: tsconfig.json 생성

{
  "extends": "@pf-dev/typescript-config/library.json",
  "compilerOptions": {
    "outDir": "./dist",
    "rootDir": "./src",
    "declaration": true,
    "declarationDir": "./dist"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

---

4단계: vite.config.ts 생성

import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import { resolve } from "path";

export default defineConfig({
  plugins: [react()],
  build: {
    lib: {
      entry: resolve(__dirname, "src/index.ts"),
      formats: ["es"],
      fileName: "index",
    },
    rollupOptions: {
      external: ["react", "react-dom"],
    },
  },
});

---

5단계: src/index.ts 생성

// Components
export * from "./components";

// Hooks
export * from "./hooks";

// Stores
export * from "./stores";

// Types
export type * from "./types";

---

6단계: ESLint 설정

// eslint.config.js
import baseConfig from "@pf-dev/eslint-config/library";

export default [...baseConfig];

---

7단계: README.md 작성

# @pf-dev/새패키지

간단한 설명

## 설치

이 패키지는 모노레포 내부 패키지입니다.

\`\`\`json
{
"dependencies": {
"@pf-dev/새패키지": "workspace:\*"
}
}
\`\`\`

## 사용법

\`\`\`tsx
import { Something } from "@pf-dev/새패키지";
\`\`\`

## API

### Components

- `ComponentName` - 설명

### Hooks

- `useHookName` - 설명

### Stores

- `useStoreName` - 설명

---

8단계: pnpm-workspace에 추가

pnpm-workspace.yaml에 이미 packages/*가 있으므로 자동 인식됩니다.

# 의존성 설치
pnpm install

# 빌드 테스트
pnpm --filter @pf-dev/새패키지 build

---

9단계: 다른 앱/패키지에서 사용

// apps/앱이름/package.json
{
  "dependencies": {
    "@pf-dev/새패키지": "workspace:*"
  }
}

pnpm install

// 사용
import { Something } from "@pf-dev/새패키지";

---

의존성 추가 시

catalog 사용 (공통 패키지)

# pnpm-workspace.yaml
catalog:
  새의존성: ^1.0.0

// package.json
{
  "dependencies": {
    "새의존성": "catalog:"
  }
}

패키지 전용 의존성

{
  "dependencies": {
    "특수패키지": "^1.0.0"
  }
}

---

체크리스트

• 폴더 구조 생성
• package.json 작성
• tsconfig.json 작성
• vite.config.ts 작성
• src/index.ts 생성
• eslint.config.js 작성
• README.md 작성
• pnpm install 실행
• 빌드 테스트
• 다른 패키지에서 import 테스트