npm - @kood/claude-code - Versions diffs - 0.3.7 → 0.3.9 - Mend

@kood/claude-code 0.3.7 → 0.3.9

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 (121) hide show

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

@@ -1,6 +1,6 @@
 # Next.js - Index
-> Next.js 15 App Router 핵심 개념
+> Next.js 15 App Router core concepts
 <context>
 @app-router.md
@@ -12,21 +12,21 @@
 ---
-## 핵심 개념
+## Core Concepts
-| 개념 | 설명 |
-|------|------|
-| **App Router** | 파일 기반 라우팅 (`app/` 디렉토리) |
-| **Server Components** | 기본 컴포넌트 (서버 렌더링) |
-| **Client Components** | `"use client"` 선언 필요 |
-| **Server Actions** | `"use server"` 함수 (타입 안전 API) |
-| **Route Handlers** | REST API 엔드포인트 (`app/api/`) |
+| 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/`) |
 ---
-## 빠른 시작
+## 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 - 기본)
+// app/page.tsx (Server Component - default)
 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 (필수)
+├── layout.tsx          # Root layout (required)
 ├── page.tsx            # Home (/)
 ├── about/
 │   └── page.tsx        # /about
@@ -81,33 +81,33 @@ app/
 ---
-## 주요 파일
+## Key Files
-| 파일 | 용도 |
-|------|------|
-| `layout.tsx` | 공통 레이아웃 (중첩 가능) |
-| `page.tsx` | 페이지 컴포넌트 |
-| `loading.tsx` | 로딩 UI (Suspense) |
-| `error.tsx` | 에러 UI (Error Boundary) |
-| `not-found.tsx` | 404 페이지 |
-| `route.ts` | API 엔드포인트 |
+| 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 |
 ---
 ## Server vs Client Components
-| 구분 | Server | Client |
-|------|--------|--------|
-| 선언 | 기본 | `"use client"` |
-| 데이터 페칭 | ✅ async/await | ❌ (useQuery 사용) |
+| Aspect | Server | Client |
+|--------|--------|--------|
+| Declaration | Default | `"use client"` |
+| Data Fetching | ✅ async/await | ❌ (use useQuery) |
 | Hooks | ❌ | ✅ useState, useEffect |
-| 브라우저 API | ❌ | ✅ window, localStorage |
+| Browser API | ❌ | ✅ window, localStorage |
 | Event Handlers | ❌ | ✅ onClick, onChange |
-**규칙:**
-- Server Component가 기본 → Client Component 필요 시만 `"use client"` 추가
-- Server Component 안에 Client Component 포함 가능
-- Client Component 안에 Server Component 불가 (props로 전달은 가능)
+**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)
 ---
@@ -183,13 +183,13 @@ export const config = {
 ---
-## 데이터 페칭
+## Data Fetching
-### Server Component (권장)
+### Server Component (recommended)
 ```typescript
 export default async function PostsPage() {
-  const posts = await prisma.post.findMany() // 직접 DB 접근
+  const posts = await prisma.post.findMany() // Direct DB access
   return <PostsList posts={posts} />
 }
 ```
@@ -213,13 +213,13 @@ export function PostsList() {
 ---
-## 캐싱
+## Caching
-| 함수 | 용도 |
-|------|------|
-| `revalidatePath("/posts")` | 특정 경로 캐시 무효화 |
-| `revalidateTag("posts")` | 태그 기반 캐시 무효화 |
-| `unstable_cache()` | 함수 결과 캐싱 |
+| Function | Purpose |
+|----------|---------|
+| `revalidatePath("/posts")` | Invalidate specific path cache |
+| `revalidateTag("posts")` | Invalidate tag-based cache |
+| `unstable_cache()` | Cache function results |
 ```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") // /posts 캐시 무효화
-  revalidateTag("posts")   // "posts" 태그 캐시 무효화
+  revalidatePath("/posts") // Invalidate /posts cache
+  revalidateTag("posts")   // Invalidate "posts" tag cache
   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"
 ```
-**규칙:**
-- `NEXT_PUBLIC_*`: 클라이언트에서 접근 가능
-- 나머지: 서버 전용
+**Rules:**
+- `NEXT_PUBLIC_*`: Accessible in client
+- Others: Server-only
 ---
-## 배포
+## Deployment
-### Vercel (권장)
+### Vercel (recommended)
 ```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 (루트)
+// middleware.ts (root)
 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 타입
+## Response Types
 ### 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
-// 다른 URL로 리다이렉트
+// Redirect to different 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
-// URL은 유지하되 다른 페이지 렌더링
+// Render different page while keeping 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일
+    maxAge: 60 * 60 * 24 * 7, // 7 days
   })
   return response
@@ -112,9 +112,9 @@ export function middleware(request: NextRequest) {
 ---
-## Headers 처리
+## Headers Handling
-### 읽기
+### 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/* 경로
+  // /api/* routes
   if (pathname.startsWith("/api/")) {
     const token = request.headers.get("authorization")
@@ -157,7 +157,7 @@ export function middleware(request: NextRequest) {
     }
   }
-  // /admin/* 경로
+  // /admin/* routes
   if (pathname.startsWith("/admin/")) {
     const role = request.cookies.get("role")?.value
@@ -172,9 +172,9 @@ export function middleware(request: NextRequest) {
 ---
-## Matcher 설정
+## Matcher Configuration
-### 배열
+### Array
 ```typescript
 export const config = {
@@ -182,23 +182,23 @@ export const config = {
 }
 ```
-### 정규식
+### Regex
 ```typescript
 export const config = {
   matcher: [
     /*
-     * 다음 경로 제외:
-     * - _next/static (정적 파일)
-     * - _next/image (이미지 최적화)
-     * - favicon.ico (파비콘)
+     * Exclude paths:
+     * - _next/static (static files)
+     * - _next/image (image optimization)
+     * - favicon.ico (favicon)
      */
     "/((?!_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분
+const WINDOW = 60 * 1000 // 1 minute
 export function middleware(request: NextRequest) {
   const ip = request.ip || "unknown"
@@ -296,7 +296,7 @@ export function middleware(request: NextRequest) {
 ---
-## A/B 테스팅
+## A/B Testing
 ```typescript
 import { NextResponse } from "next/server"
@@ -332,12 +332,12 @@ export const config = {
 ---
-## 베스트 프랙티스
+## Best Practices
 ### ✅ DO
 ```typescript
-// 1. 가벼운 로직만
+// 1. Keep logic lightweight
 export function middleware(request: NextRequest) {
   const token = request.cookies.get("token")
@@ -348,7 +348,7 @@ export function middleware(request: NextRequest) {
   return NextResponse.next()
 }
-// 2. matcher 설정
+// 2. Configure matcher
 export const config = {
   matcher: ["/dashboard/:path*"],
 }
@@ -357,23 +357,23 @@ export const config = {
 ### ❌ DON'T
 ```typescript
-// 1. 무거운 DB 쿼리
+// 1. Heavy database queries
 export async function middleware(request: NextRequest) {
-  // ❌ 미들웨어에서 DB 쿼리 금지
+  // ❌ No DB queries in middleware
   const user = await prisma.user.findUnique({ where: { id: "..." } })
   return NextResponse.next()
 }
-// 2. matcher 없이 모든 요청 처리
+// 2. Processing all requests without matcher
 export function middleware(request: NextRequest) {
-  // ❌ 성능 저하
+  // ❌ Performance degradation
   return NextResponse.next()
 }
 ```
 ---
-## NextAuth.js와 함께 사용
+## Using with 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 엔드포인트 (`app/api/`)
+> REST API endpoints (`app/api/`)
 ---
-## 기본 사용법
+## Basic Usage
 ```typescript
 // app/api/posts/route.ts
@@ -24,7 +24,7 @@ export async function POST(request: NextRequest) {
 ---
-## HTTP 메서드
+## HTTP Methods
 ```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 처리
+## Request Processing
 ### 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 처리
+## Response Processing
 ### 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일
+    maxAge: 60 * 60 * 24 * 7, // 7 days
   })
   return NextResponse.json({ success: true })
@@ -194,7 +194,7 @@ export async function GET() {
 ---
-## Zod 검증
+## Zod Validation
 ```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 (n초마다 재생성)
-export const revalidate = 60 // 60초
+// Revalidate (regenerate every n seconds)
+export const revalidate = 60 // 60 seconds
 export async function GET() {
   const posts = await prisma.post.findMany()
@@ -363,20 +363,20 @@ export async function GET() {
 ## Server Actions vs Route Handlers
-| 기준 | Server Actions | Route Handlers |
-|------|----------------|----------------|
-| **용도** | 폼 제출, 뮤테이션 | REST API, 외부 연동 |
-| **타입** | ✅ 자동 타입 추론 | ❌ 수동 타입 정의 |
-| **캐싱** | revalidatePath | export const revalidate |
-| **인증** | await auth() | await auth() |
-| **권장** | 내부 API | 외부 API, 웹훅 |
+| 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 |
-**권장 사항:**
-- 내부 API → Server Actions
-- 외부 API, 웹훅, 써드파티 연동 → Route Handlers
+**Recommendation:**
+- Internal API → Server Actions
+- External API, webhooks, third-party integration → Route Handlers
 ---
-## 참조
+## References
 - [Next.js Route Handlers](https://nextjs.org/docs/app/building-your-application/routing/route-handlers)