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/app-router.md CHANGED Viewed

@@ -1,22 +1,22 @@
 # App Router
-> File-based routing system
+> 파일 기반 라우팅 시스템
 ---
-## File Structure and Routing
+## 파일 구조와 라우팅
-### Basic Rules
+### 기본 규칙
-| File | Route | Description |
-|------|-------|-------------|
-| `app/page.tsx` | `/` | Home page |
-| `app/about/page.tsx` | `/about` | About page |
-| `app/blog/[slug]/page.tsx` | `/blog/:slug` | Dynamic route |
+| 파일 | 라우트 | 설명 |
+|------|--------|------|
+| `app/page.tsx` | `/` | 홈 페이지 |
+| `app/about/page.tsx` | `/about` | About 페이지 |
+| `app/blog/[slug]/page.tsx` | `/blog/:slug` | 동적 라우트 |
 | `app/shop/[...slug]/page.tsx` | `/shop/*` | Catch-all |
 | `app/docs/[[...slug]]/page.tsx` | `/docs/*` | Optional catch-all |
-### Example
+### 예시
 ```typescript
 // app/blog/[slug]/page.tsx
@@ -38,20 +38,20 @@ export default async function BlogPost({ params, searchParams }: PageProps) {
 ## Layouts
-### Root Layout (required)
+### Root Layout (필수)
 ```typescript
 // app/layout.tsx
 export default function RootLayout({ children }: { children: React.ReactNode }) {
   return (
-    <html lang="en">
+    <html lang="ko">
       <body>{children}</body>
     </html>
   )
 }
 ```
-### Nested Layout
+### 중첩 Layout
 ```typescript
 // app/dashboard/layout.tsx
@@ -65,10 +65,10 @@ export default function DashboardLayout({ children }: { children: React.ReactNod
 }
 ```
-**Features:**
-- Nestable (parent → child order)
-- Persists without re-rendering
-- Receives `children` as props
+**특징:**
+- 중첩 가능 (부모 → 자식 순서)
+- 리렌더링 없이 유지됨
+- props로 `children` 받음
 ---
@@ -87,15 +87,15 @@ app/
         └── page.tsx    # /products
 ```
-**Purpose:**
-- Group folders without affecting URLs
-- Apply different layouts
+**용도:**
+- URL에 영향 없이 폴더 그룹화
+- 다른 레이아웃 적용
 ---
-## Dynamic Routes
+## 동적 라우트
-### Single Parameter
+### 단일 파라미터
 ```typescript
 // app/posts/[id]/page.tsx
@@ -104,7 +104,7 @@ export default async function PostPage({ params }: { params: { id: string } }) {
   return <article>{post.title}</article>
 }
-// Static generation (at build time)
+// 정적 생성 (빌드 시)
 export async function generateStaticParams() {
   const posts = await prisma.post.findMany()
   return posts.map(post => ({ id: post.id }))
@@ -123,7 +123,7 @@ export default function DocsPage({ params }: { params: { slug: string[] } }) {
 ---
-## Parallel Routes
+## 병렬 라우트
 ```
 app/
@@ -157,7 +157,7 @@ export default function Layout({
 ---
-## Intercepting Routes
+## 인터셉팅 라우트
 ```
 app/
@@ -172,11 +172,11 @@ app/
             └── page.tsx
 ```
-**Conventions:**
-- `(.)` - same level
-- `(..)` - one level up
-- `(..)(..)` - two levels up
-- `(...)` - from root
+**컨벤션:**
+- `(.)` - 같은 레벨
+- `(..)` - 한 단계 위
+- `(..)(..)` - 두 단계 위
+- `(...)` - 루트부터
 ---
@@ -203,15 +203,15 @@ export async function generateMetadata({ params }: { params: { slug: string } })
 ---
-## Special Files
+## 특수 파일
-| File | Purpose |
-|------|---------|
-| `loading.tsx` | Suspense fallback |
+| 파일 | 용도 |
+|------|------|
+| `loading.tsx` | Suspense 폴백 |
 | `error.tsx` | Error Boundary |
-| `not-found.tsx` | 404 page |
-| `template.tsx` | Re-rendering Layout |
-| `default.tsx` | Parallel route fallback |
+| `not-found.tsx` | 404 페이지 |
+| `template.tsx` | 리렌더링되는 Layout |
+| `default.tsx` | 병렬 라우트 폴백 |
 ### Loading UI
@@ -231,8 +231,8 @@ export default function Loading() {
 export default function Error({ error, reset }: { error: Error; reset: () => void }) {
   return (
     <div>
-      <h2>An error occurred</h2>
-      <button onClick={reset}>Try again</button>
+      <h2>오류 발생</h2>
+      <button onClick={reset}>다시 시도</button>
     </div>
   )
 }
@@ -240,7 +240,7 @@ export default function Error({ error, reset }: { error: Error; reset: () => voi
 ---
-## Navigation
+## 네비게이션
 ```typescript
 "use client"
@@ -250,8 +250,8 @@ import Link from "next/link"
 export function Navigation() {
   const router = useRouter()
-  const pathname = usePathname() // current path
-  const searchParams = useSearchParams() // query parameters
+  const pathname = usePathname() // 현재 경로
+  const searchParams = useSearchParams() // 쿼리 파라미터
   return (
     <>
@@ -264,6 +264,6 @@ export function Navigation() {
 ---
-## References
+## 참조
-- [Next.js App Router Official Docs](https://nextjs.org/docs/app)
+- [Next.js App Router 공식 문서](https://nextjs.org/docs/app)

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

@@ -1,32 +1,32 @@
 # Caching
-> Next.js caching strategies
+> Next.js 캐싱 전략
 ---
-## Cache Levels
+## 캐시 레벨
-| Level | Description |
-|-------|-------------|
-| **Request Memoization** | Deduplicate same requests (React) |
-| **Data Cache** | Server data cache (persistent) |
-| **Full Route Cache** | Static rendering at build time |
-| **Router Cache** | Client-side router cache |
+| 레벨 | 설명 |
+|------|------|
+| **Request Memoization** | 같은 요청 중복 제거 (React) |
+| **Data Cache** | 서버 데이터 캐시 (영구) |
+| **Full Route Cache** | 빌드 시 정적 렌더링 |
+| **Router Cache** | 클라이언트 라우터 캐시 |
 ---
 ## Request Memoization
 ```typescript
-// Same requests execute only once
+// 같은 요청은 한 번만 실행됨
 async function getUser(id: string) {
   const res = await fetch(`https://api.example.com/users/${id}`)
   return res.json()
 }
 export default async function Page() {
-  const user1 = await getUser("1") // fetch executes
-  const user2 = await getUser("1") // cache used (deduplicated)
+  const user1 = await getUser("1") // fetch 실행
+  const user2 = await getUser("1") // 캐시 사용 (중복 제거)
   return <div>{user1.name}</div>
 }
@@ -36,52 +36,52 @@ export default async function Page() {
 ## Data Cache (fetch)
-### Default (cached)
+### 기본 (캐시 사용)
 ```typescript
-// Cached by default
+// 기본적으로 캐시됨
 const res = await fetch("https://api.example.com/posts")
 ```
-### Disable Cache
+### 캐시 비활성화
 ```typescript
-// Fetch fresh data on every request
+// 매 요청마다 새로 가져옴
 const res = await fetch("https://api.example.com/posts", {
   cache: "no-store",
 })
 ```
-### Revalidate (time-based)
+### Revalidate (시간 기반)
 ```typescript
-// Revalidate every 60 seconds
+// 60초마다 재검증
 const res = await fetch("https://api.example.com/posts", {
   next: { revalidate: 60 },
 })
 ```
-### Tag-based Cache
+### Tag 기반 캐시
 ```typescript
-// Set tag
+// 태그 설정
 const res = await fetch("https://api.example.com/posts", {
   next: { tags: ["posts"] },
 })
-// Invalidate tag in Server Action
+// Server Action에서 태그 무효화
 "use server"
 import { revalidateTag } from "next/cache"
 export async function createPost(data: PostInput) {
   await prisma.post.create({ data })
-  revalidateTag("posts") // Invalidate "posts" tag cache
+  revalidateTag("posts") // "posts" 태그 캐시 무효화
 }
 ```
 ---
-## unstable_cache (function caching)
+## unstable_cache (함수 캐싱)
 ```typescript
 import { unstable_cache } from "next/cache"
@@ -90,10 +90,10 @@ const getCachedPosts = unstable_cache(
   async () => {
     return prisma.post.findMany()
   },
-  ["posts"], // cache key
+  ["posts"], // 캐시 키
   {
-    revalidate: 60, // 60 seconds
-    tags: ["posts"], // tags
+    revalidate: 60, // 60초
+    tags: ["posts"], // 태그
   }
 )
@@ -115,11 +115,11 @@ import { revalidatePath } from "next/cache"
 export async function createPost(data: PostInput) {
   const post = await prisma.post.create({ data })
-  // Invalidate specific path cache
+  // 특정 경로 캐시 무효화
   revalidatePath("/posts")
   revalidatePath(`/posts/${post.id}`)
-  // Invalidate all caches including layout
+  // 레이아웃 포함 모든 캐시 무효화
   revalidatePath("/posts", "layout")
   return post
@@ -138,7 +138,7 @@ import { revalidateTag } from "next/cache"
 export async function createPost(data: PostInput) {
   const post = await prisma.post.create({ data })
-  // Invalidate all caches with "posts" tag
+  // "posts" 태그가 붙은 모든 캐시 무효화
   revalidateTag("posts")
   return post
@@ -147,22 +147,22 @@ export async function createPost(data: PostInput) {
 ---
-## Full Route Cache (static rendering)
+## Full Route Cache (정적 렌더링)
-### Static Page
+### 정적 페이지
 ```typescript
-// Generated at build time (default)
+// 빌드 시 생성 (기본)
 export default async function PostsPage() {
   const posts = await prisma.post.findMany()
   return <PostsList posts={posts} />
 }
 ```
-### Dynamic Page (disable cache)
+### 동적 페이지 (캐시 비활성화)
 ```typescript
-// Render on every request
+// 매 요청마다 렌더링
 export const dynamic = "force-dynamic"
 export default async function PostsPage() {
@@ -171,10 +171,10 @@ export default async function PostsPage() {
 }
 ```
-### Revalidate (time-based)
+### Revalidate (시간 기반)
 ```typescript
-// Regenerate every 60 seconds
+// 60초마다 재생성
 export const revalidate = 60
 export default async function PostsPage() {
@@ -190,16 +190,16 @@ export default async function PostsPage() {
 ```typescript
 // app/posts/page.tsx
-// Force dynamic rendering
+// 동적 렌더링 강제
 export const dynamic = "force-dynamic" // "auto" | "force-static" | "error"
-// Revalidate interval (seconds)
+// Revalidate 주기 (초)
 export const revalidate = 60 // false | 0 | number
-// Runtime configuration
+// 런타임 설정
 export const runtime = "nodejs" // "edge"
-// Maximum execution time (seconds)
+// 최대 실행 시간 (초)
 export const maxDuration = 60
 export default async function PostsPage() {
@@ -209,7 +209,7 @@ export default async function PostsPage() {
 ---
-## Router Cache (client-side)
+## Router Cache (클라이언트)
 ```typescript
 "use client"
@@ -222,8 +222,8 @@ export function Navigation() {
   return (
     <button
       onClick={() => {
-        router.push("/posts") // Use cached page
-        router.refresh() // Force refresh
+        router.push("/posts") // 캐시된 페이지 사용
+        router.refresh() // 강제 새로고침
       }}
     >
       Go to Posts
@@ -234,12 +234,12 @@ export function Navigation() {
 ---
-## generateStaticParams (dynamic routes)
+## generateStaticParams (동적 라우트)
 ```typescript
 // app/posts/[id]/page.tsx
-// List of pages to generate at build time
+// 빌드 시 생성할 페이지 목록
 export async function generateStaticParams() {
   const posts = await prisma.post.findMany({ select: { id: true } })
   return posts.map(post => ({ id: post.id }))
@@ -253,40 +253,40 @@ export default async function PostPage({ params }: { params: { id: string } }) {
 ---
-## Caching Flow
+## 캐싱 플로우
-### Static Page
+### 정적 페이지
 ```
-1. Render at build time
-2. Save to Full Route Cache
-3. Subsequent requests use cache
-4. Regenerate after revalidate time
+1. 빌드 시 렌더링
+2. Full Route Cache 저장
+3. 이후 요청은 캐시 사용
+4. revalidate 시간 후 재생성
 ```
-### Dynamic Page
+### 동적 페이지
 ```
-1. Render on every request
-2. No cache
-3. Update data with Server Actions
-4. Invalidate only specific paths with revalidatePath
+1. 매 요청마다 렌더링
+2. 캐시 없음
+3. Server Actions로 데이터 업데이트
+4. revalidatePath로 특정 경로만 무효화
 ```
 ---
-## Cache Invalidation Strategies
+## 캐시 무효화 전략
-### Time-based
+### 시간 기반
 ```typescript
-// Regenerate every 60 seconds
+// 60초마다 재생성
 export const revalidate = 60
 const res = await fetch("...", { next: { revalidate: 60 } })
 ```
-### On-demand (Server Actions)
+### 온디맨드 (Server Actions)
 ```typescript
 "use server"
@@ -296,34 +296,34 @@ import { revalidatePath, revalidateTag } from "next/cache"
 export async function updatePost(id: string, data: PostInput) {
   await prisma.post.update({ where: { id }, data })
-  // Path invalidation
+  // 경로 무효화
   revalidatePath(`/posts/${id}`)
-  // Tag invalidation
+  // 태그 무효화
   revalidateTag("posts")
 }
 ```
 ---
-## Best Practices
+## 베스트 프랙티스
 ### ✅ DO
 ```typescript
-// 1. Use default cache for static data
+// 1. 정적 데이터는 기본 캐시 사용
 const posts = await fetch("https://api.example.com/posts")
-// 2. Use no-store for dynamic data
+// 2. 동적 데이터는 no-store
 const user = await fetch("https://api.example.com/user", {
   cache: "no-store",
 })
-// 3. Tag-based invalidation
+// 3. 태그 기반 무효화
 const posts = await fetch("...", { next: { tags: ["posts"] } })
 revalidateTag("posts")
-// 4. Function caching
+// 4. 함수 캐싱
 const getCachedData = unstable_cache(
   async () => prisma.post.findMany(),
   ["posts"],
@@ -334,18 +334,18 @@ const getCachedData = unstable_cache(
 ### ❌ DON'T
 ```typescript
-// 1. Caching sensitive data
-const user = await fetch("/api/user") // ❌ Don't cache personal data
+// 1. 민감한 데이터 캐싱
+const user = await fetch("/api/user") // ❌ 개인정보 캐싱 금지
-// 2. Excessive revalidatePath
-revalidatePath("/") // ❌ Invalidates entire site
+// 2. 과도한 revalidatePath
+revalidatePath("/") // ❌ 전체 사이트 무효화
-// 3. Short revalidate interval
-export const revalidate = 1 // ❌ Increases load
+// 3. 짧은 revalidate
+export const revalidate = 1 // ❌ 부하 증가
 ```
 ---
-## References
+## 참조
 - [Next.js Caching](https://nextjs.org/docs/app/building-your-application/caching)