npm - @kood/claude-code - Versions diffs - 0.5.3 → 0.5.5 - Mend

@kood/claude-code 0.5.3 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (125) hide show

package/templates/nextjs/docs/library/nextjs/index.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # Next.js - Index
-> Next.js 15 App Router core concepts
+> Next.js 15 App Router 핵심 개념
 <context>
 @app-router.md
@@ -12,21 +12,21 @@
 ---
-## Core Concepts
+## 핵심 개념
-| Concept | Description |
-|---------|-------------|
-| **App Router** | File-based routing (`app/` directory) |
-| **Server Components** | Default components (server rendering) |
-| **Client Components** | Requires `"use client"` declaration |
-| **Server Actions** | `"use server"` functions (type-safe API) |
-| **Route Handlers** | REST API endpoints (`app/api/`) |
+| 개념 | 설명 |
+|------|------|
+| **App Router** | 파일 기반 라우팅 (`app/` 디렉토리) |
+| **Server Components** | 기본 컴포넌트 (서버 렌더링) |
+| **Client Components** | `"use client"` 선언 필요 |
+| **Server Actions** | `"use server"` 함수 (타입 안전 API) |
+| **Route Handlers** | REST API 엔드포인트 (`app/api/`) |
 ---
-## Quick Start
+## 빠른 시작
-### Create Project
+### 프로젝트 생성
 ```bash
 npx create-next-app@latest my-app --typescript --tailwind --app
@@ -34,10 +34,10 @@ cd my-app
 npm run dev
 ```
-### Basic Page
+### 기본 페이지
 ```typescript
-// app/page.tsx (Server Component - default)
+// app/page.tsx (Server Component - 기본)
 export default async function HomePage() {
   const data = await fetch('https://api.example.com/data')
   const json = await data.json()
@@ -62,11 +62,11 @@ export function Counter() {
 ---
-## File Structure
+## 파일 구조
 ```
 app/
-├── layout.tsx          # Root layout (required)
+├── layout.tsx          # Root layout (필수)
 ├── page.tsx            # Home (/)
 ├── about/
 │   └── page.tsx        # /about
@@ -81,33 +81,33 @@ app/
 ---
-## Key Files
+## 주요 파일
-| File | Purpose |
-|------|---------|
-| `layout.tsx` | Shared layout (nestable) |
-| `page.tsx` | Page component |
-| `loading.tsx` | Loading UI (Suspense) |
-| `error.tsx` | Error UI (Error Boundary) |
-| `not-found.tsx` | 404 page |
-| `route.ts` | API endpoint |
+| 파일 | 용도 |
+|------|------|
+| `layout.tsx` | 공통 레이아웃 (중첩 가능) |
+| `page.tsx` | 페이지 컴포넌트 |
+| `loading.tsx` | 로딩 UI (Suspense) |
+| `error.tsx` | 에러 UI (Error Boundary) |
+| `not-found.tsx` | 404 페이지 |
+| `route.ts` | API 엔드포인트 |
 ---
 ## Server vs Client Components
-| Aspect | Server | Client |
-|--------|--------|--------|
-| Declaration | Default | `"use client"` |
-| Data Fetching | ✅ async/await | ❌ (use useQuery) |
+| 구분 | Server | Client |
+|------|--------|--------|
+| 선언 | 기본 | `"use client"` |
+| 데이터 페칭 | ✅ async/await | ❌ (useQuery 사용) |
 | Hooks | ❌ | ✅ useState, useEffect |
-| Browser API | ❌ | ✅ window, localStorage |
+| 브라우저 API | ❌ | ✅ window, localStorage |
 | Event Handlers | ❌ | ✅ onClick, onChange |
-**Rules:**
-- Server Components are default → add `"use client"` only when needed
-- Server Components can contain Client Components
-- Client Components cannot contain Server Components (but can receive them as props)
+**규칙:**
+- Server Component가 기본 → Client Component 필요 시만 `"use client"` 추가
+- Server Component 안에 Client Component 포함 가능
+- Client Component 안에 Server Component 불가 (props로 전달은 가능)
 ---
@@ -183,13 +183,13 @@ export const config = {
 ---
-## Data Fetching
+## 데이터 페칭
-### Server Component (recommended)
+### Server Component (권장)
 ```typescript
 export default async function PostsPage() {
-  const posts = await prisma.post.findMany() // Direct DB access
+  const posts = await prisma.post.findMany() // 직접 DB 접근
   return <PostsList posts={posts} />
 }
 ```
@@ -213,13 +213,13 @@ export function PostsList() {
 ---
-## Caching
+## 캐싱
-| Function | Purpose |
-|----------|---------|
-| `revalidatePath("/posts")` | Invalidate specific path cache |
-| `revalidateTag("posts")` | Invalidate tag-based cache |
-| `unstable_cache()` | Cache function results |
+| 함수 | 용도 |
+|------|------|
+| `revalidatePath("/posts")` | 특정 경로 캐시 무효화 |
+| `revalidateTag("posts")` | 태그 기반 캐시 무효화 |
+| `unstable_cache()` | 함수 결과 캐싱 |
 ```typescript
 import { revalidatePath, revalidateTag } from "next/cache"
@@ -227,8 +227,8 @@ import { revalidatePath, revalidateTag } from "next/cache"
 export async function createPost(data: PostInput) {
   const post = await prisma.post.create({ data })
-  revalidatePath("/posts") // Invalidate /posts cache
-  revalidateTag("posts")   // Invalidate "posts" tag cache
+  revalidatePath("/posts") // /posts 캐시 무효화
+  revalidateTag("posts")   // "posts" 태그 캐시 무효화
   return post
 }
@@ -236,7 +236,7 @@ export async function createPost(data: PostInput) {
 ---
-## Environment Variables
+## 환경 변수
 ```bash
 # .env.local
@@ -246,15 +246,15 @@ NEXTAUTH_URL="http://localhost:3000"
 NEXT_PUBLIC_API_URL="https://api.example.com"
 ```
-**Rules:**
-- `NEXT_PUBLIC_*`: Accessible in client
-- Others: Server-only
+**규칙:**
+- `NEXT_PUBLIC_*`: 클라이언트에서 접근 가능
+- 나머지: 서버 전용
 ---
-## Deployment
+## 배포
-### Vercel (recommended)
+### Vercel (권장)
 ```bash
 npm i -g vercel
@@ -282,7 +282,7 @@ npm start
 ---
-## References
+## 참조
 - [App Router](app-router.md)
 - [Server Actions](server-actions.md)

package/templates/nextjs/docs/library/nextjs/middleware.md CHANGED Viewed

@@ -1,22 +1,22 @@
 # Middleware
-> Functions executed before request processing
+> 요청 처리 전 실행되는 함수
 ---
-## Basic Usage
+## 기본 사용법
 ```typescript
-// middleware.ts (root)
+// middleware.ts (루트)
 import { NextResponse } from "next/server"
 import type { NextRequest } from "next/server"
 export function middleware(request: NextRequest) {
-  // Execute logic...
+  // 로직 실행...
   return NextResponse.next()
 }
-// Matcher configuration
+// 매처 설정
 export const config = {
   matcher: ["/dashboard/:path*", "/api/:path*"],
 }
@@ -24,12 +24,12 @@ export const config = {
 ---
-## Response Types
+## Response 타입
 ### NextResponse.next()
 ```typescript
-// Pass request to next middleware or route
+// 요청을 다음 미들웨어 또는 라우트로 전달
 export function middleware(request: NextRequest) {
   return NextResponse.next()
 }
@@ -38,7 +38,7 @@ export function middleware(request: NextRequest) {
 ### NextResponse.redirect()
 ```typescript
-// Redirect to different URL
+// 다른 URL로 리다이렉트
 export function middleware(request: NextRequest) {
   return NextResponse.redirect(new URL("/login", request.url))
 }
@@ -47,7 +47,7 @@ export function middleware(request: NextRequest) {
 ### NextResponse.rewrite()
 ```typescript
-// Render different page while keeping URL
+// URL은 유지하되 다른 페이지 렌더링
 export function middleware(request: NextRequest) {
   return NextResponse.rewrite(new URL("/dashboard/home", request.url))
 }
@@ -55,7 +55,7 @@ export function middleware(request: NextRequest) {
 ---
-## Authentication
+## 인증
 ```typescript
 import { NextResponse } from "next/server"
@@ -64,7 +64,7 @@ import type { NextRequest } from "next/server"
 export function middleware(request: NextRequest) {
   const token = request.cookies.get("token")
-  // Redirect to login if no token
+  // 토큰 없으면 로그인 페이지로
   if (!token) {
     return NextResponse.redirect(new URL("/login", request.url))
   }
@@ -79,9 +79,9 @@ export const config = {
 ---
-## Cookie Handling
+## 쿠키 처리
-### Reading
+### 읽기
 ```typescript
 export function middleware(request: NextRequest) {
@@ -94,7 +94,7 @@ export function middleware(request: NextRequest) {
 }
 ```
-### Setting
+### 설정
 ```typescript
 export function middleware(request: NextRequest) {
@@ -103,7 +103,7 @@ export function middleware(request: NextRequest) {
   response.cookies.set("visited", "true", {
     httpOnly: true,
     secure: true,
-    maxAge: 60 * 60 * 24 * 7, // 7 days
+    maxAge: 60 * 60 * 24 * 7, // 7일
   })
   return response
@@ -112,9 +112,9 @@ export function middleware(request: NextRequest) {
 ---
-## Headers Handling
+## Headers 처리
-### Reading
+### 읽기
 ```typescript
 export function middleware(request: NextRequest) {
@@ -127,7 +127,7 @@ export function middleware(request: NextRequest) {
 }
 ```
-### Setting
+### 설정
 ```typescript
 export function middleware(request: NextRequest) {
@@ -142,13 +142,13 @@ export function middleware(request: NextRequest) {
 ---
-## Path-based Processing
+## 경로별 처리
 ```typescript
 export function middleware(request: NextRequest) {
   const { pathname } = request.nextUrl
-  // /api/* routes
+  // /api/* 경로
   if (pathname.startsWith("/api/")) {
     const token = request.headers.get("authorization")
@@ -157,7 +157,7 @@ export function middleware(request: NextRequest) {
     }
   }
-  // /admin/* routes
+  // /admin/* 경로
   if (pathname.startsWith("/admin/")) {
     const role = request.cookies.get("role")?.value
@@ -172,9 +172,9 @@ export function middleware(request: NextRequest) {
 ---
-## Matcher Configuration
+## Matcher 설정
-### Array
+### 배열
 ```typescript
 export const config = {
@@ -182,23 +182,23 @@ export const config = {
 }
 ```
-### Regex
+### 정규식
 ```typescript
 export const config = {
   matcher: [
     /*
-     * Exclude paths:
-     * - _next/static (static files)
-     * - _next/image (image optimization)
-     * - favicon.ico (favicon)
+     * 다음 경로 제외:
+     * - _next/static (정적 파일)
+     * - _next/image (이미지 최적화)
+     * - favicon.ico (파비콘)
      */
     "/((?!_next/static|_next/image|favicon.ico).*)",
   ],
 }
 ```
-### Conditional
+### 조건부
 ```typescript
 export const config = {
@@ -216,7 +216,7 @@ export const config = {
 ---
-## Logging
+## 로깅
 ```typescript
 export function middleware(request: NextRequest) {
@@ -248,7 +248,7 @@ import type { NextRequest } from "next/server"
 const rateLimit = new Map<string, { count: number; resetAt: number }>()
 const LIMIT = 10 // 10 requests
-const WINDOW = 60 * 1000 // 1 minute
+const WINDOW = 60 * 1000 // 1분
 export function middleware(request: NextRequest) {
   const ip = request.ip || "unknown"
@@ -296,7 +296,7 @@ export function middleware(request: NextRequest) {
 ---
-## A/B Testing
+## A/B 테스팅
 ```typescript
 import { NextResponse } from "next/server"
@@ -332,12 +332,12 @@ export const config = {
 ---
-## Best Practices
+## 베스트 프랙티스
 ### ✅ DO
 ```typescript
-// 1. Keep logic lightweight
+// 1. 가벼운 로직만
 export function middleware(request: NextRequest) {
   const token = request.cookies.get("token")
@@ -348,7 +348,7 @@ export function middleware(request: NextRequest) {
   return NextResponse.next()
 }
-// 2. Configure matcher
+// 2. matcher 설정
 export const config = {
   matcher: ["/dashboard/:path*"],
 }
@@ -357,23 +357,23 @@ export const config = {
 ### ❌ DON'T
 ```typescript
-// 1. Heavy database queries
+// 1. 무거운 DB 쿼리
 export async function middleware(request: NextRequest) {
-  // ❌ No DB queries in middleware
+  // ❌ 미들웨어에서 DB 쿼리 금지
   const user = await prisma.user.findUnique({ where: { id: "..." } })
   return NextResponse.next()
 }
-// 2. Processing all requests without matcher
+// 2. matcher 없이 모든 요청 처리
 export function middleware(request: NextRequest) {
-  // ❌ Performance degradation
+  // ❌ 성능 저하
   return NextResponse.next()
 }
 ```
 ---
-## Using with NextAuth.js
+## NextAuth.js와 함께 사용
 ```typescript
 // middleware.ts
@@ -386,6 +386,6 @@ export const config = {
 ---
-## References
+## 참조
 - [Next.js Middleware](https://nextjs.org/docs/app/building-your-application/routing/middleware)

package/templates/nextjs/docs/library/nextjs/route-handlers.md CHANGED Viewed

@@ -1,10 +1,10 @@
 # Route Handlers
-> REST API endpoints (`app/api/`)
+> REST API 엔드포인트 (`app/api/`)
 ---
-## Basic Usage
+## 기본 사용법
 ```typescript
 // app/api/posts/route.ts
@@ -24,7 +24,7 @@ export async function POST(request: NextRequest) {
 ---
-## HTTP Methods
+## HTTP 메서드
 ```typescript
 // app/api/posts/route.ts
@@ -39,7 +39,7 @@ export async function OPTIONS(request: NextRequest) {}
 ---
-## Dynamic Routes
+## 동적 라우트
 ```typescript
 // app/api/posts/[id]/route.ts
@@ -67,7 +67,7 @@ export async function DELETE(
 ---
-## Request Processing
+## Request 처리
 ### Query Parameters
@@ -112,7 +112,7 @@ export async function POST(request: NextRequest) {
   const title = formData.get("title") as string
   const file = formData.get("file") as File
-  // File processing...
+  // 파일 처리...
   return NextResponse.json({ success: true })
 }
@@ -125,7 +125,7 @@ export async function GET(request: NextRequest) {
   const token = request.headers.get("authorization")
   const userAgent = request.headers.get("user-agent")
-  // Use headers...
+  // 헤더 사용...
   return NextResponse.json({ data: "..." })
 }
@@ -133,7 +133,7 @@ export async function GET(request: NextRequest) {
 ---
-## Response Processing
+## Response 처리
 ### JSON Response
@@ -178,14 +178,14 @@ import { cookies } from "next/headers"
 export async function GET() {
   const cookieStore = cookies()
-  // Read cookie
+  // 쿠키 읽기
   const token = cookieStore.get("token")
-  // Set cookie
+  // 쿠키 설정
   cookieStore.set("token", "value", {
     httpOnly: true,
     secure: true,
-    maxAge: 60 * 60 * 24 * 7, // 7 days
+    maxAge: 60 * 60 * 24 * 7, // 7일
   })
   return NextResponse.json({ success: true })
@@ -194,7 +194,7 @@ export async function GET() {
 ---
-## Zod Validation
+## Zod 검증
 ```typescript
 import { z } from "zod"
@@ -229,7 +229,7 @@ export async function POST(request: NextRequest) {
 ---
-## Authentication
+## 인증
 ```typescript
 import { auth } from "@/lib/auth"
@@ -286,7 +286,7 @@ export async function OPTIONS() {
 ---
-## Streaming
+## 스트리밍
 ```typescript
 export async function GET() {
@@ -314,7 +314,7 @@ export async function GET() {
 ---
-## Error Handling
+## 에러 처리
 ```typescript
 export async function GET(
@@ -341,17 +341,17 @@ export async function GET(
 ---
-## Caching
+## 캐싱
 ```typescript
-// Static response (generated at build time)
+// 정적 응답 (빌드 시 생성)
 export const dynamic = "force-static"
-// Dynamic response (every request)
+// 동적 응답 (매 요청마다)
 export const dynamic = "force-dynamic"
-// Revalidate (regenerate every n seconds)
-export const revalidate = 60 // 60 seconds
+// Revalidate (n초마다 재생성)
+export const revalidate = 60 // 60초
 export async function GET() {
   const posts = await prisma.post.findMany()
@@ -363,20 +363,20 @@ export async function GET() {
 ## Server Actions vs Route Handlers
-| Criteria | Server Actions | Route Handlers |
-|----------|----------------|----------------|
-| **Purpose** | Form submissions, mutations | REST API, external integration |
-| **Types** | ✅ Automatic type inference | ❌ Manual type definition |
-| **Caching** | revalidatePath | export const revalidate |
-| **Auth** | await auth() | await auth() |
-| **Recommended** | Internal API | External API, webhooks |
+| 기준 | Server Actions | Route Handlers |
+|------|----------------|----------------|
+| **용도** | 폼 제출, 뮤테이션 | REST API, 외부 연동 |
+| **타입** | ✅ 자동 타입 추론 | ❌ 수동 타입 정의 |
+| **캐싱** | revalidatePath | export const revalidate |
+| **인증** | await auth() | await auth() |
+| **권장** | 내부 API | 외부 API, 웹훅 |
-**Recommendation:**
-- Internal API → Server Actions
-- External API, webhooks, third-party integration → Route Handlers
+**권장 사항:**
+- 내부 API → Server Actions
+- 외부 API, 웹훅, 써드파티 연동 → Route Handlers
 ---
-## References
+## 참조
 - [Next.js Route Handlers](https://nextjs.org/docs/app/building-your-application/routing/route-handlers)