@kood/claude-code 0.5.4 → 0.5.5

package/templates/nextjs/docs/library/prisma/schema.md

@@ -1,21 +1,21 @@
-# Prisma - Schema Definition (Multi-File)
+# Prisma - 스키마 정의 (Multi-File)
 
-## ⚠️ Required Rules
+## ⚠️ 필수 규칙
 
-1. **Use Multi-File structure**
-2. **Add comments to all elements** (files, models, fields, enums)
+1. **Multi-File 구조** 사용
+2. **모든 요소에 한글 주석** (파일, 모델, 필드, enum)
 
-## Structure
+## 구조
 
 ```
 prisma/schema/
 ├── +base.prisma    # datasource, generator
-├── +enum.prisma    # all enums
-├── user.prisma     # User model
-└── post.prisma     # Post model
+├── +enum.prisma    # 모든 enum
+├── user.prisma     # User 모델
+└── post.prisma     # Post 모델
 ```
 
-## Example
+## 예시
 
 ```prisma
 // +base.prisma
@@ -31,24 +31,24 @@ generator client {
 
 // +enum.prisma
 enum Role {
-  USER   // regular user
-  ADMIN  // administrator
+  USER   // 일반 사용자
+  ADMIN  // 관리자
 }
 
 // user.prisma
 model User {
   id        Int      @id @default(autoincrement())
-  email     String   @unique  // login email
-  name      String?           // display name
+  email     String   @unique  // 로그인 이메일
+  name      String?           // 표시 이름
   role      Role     @default(USER)
-  posts     Post[]            // authored posts (1:N)
-  profile   Profile?          // user profile (1:1)
+  posts     Post[]            // 작성 게시글 (1:N)
+  profile   Profile?          // 프로필 (1:1)
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 }
 ```
 
-## Relation Types
+## 관계 유형
 
 ```prisma
 // 1:1
@@ -64,11 +64,11 @@ model Post {
   authorId Int
 }
 
-// M:N (implicit)
+// M:N (암묵적)
 model Post { categories Category[] }
 model Category { posts Post[] }
 
-// M:N (explicit)
+// M:N (명시적)
 model CategoriesOnPosts {
   post       Post     @relation(fields: [postId], references: [id])
   postId     Int
@@ -78,21 +78,21 @@ model CategoriesOnPosts {
 }
 ```
 
-## Others
+## 기타
 
 ```prisma
-// Optional relation
+// 선택적 관계
 author   User? @relation(fields: [authorId], references: [id])
 authorId Int?
 
-// Index
+// 인덱스
 @@index([authorId])
 @@index([createdAt])
 
-// Composite key
+// 복합 키
 @@id([postId, tagId])
 
-// Mapping
+// 매핑
 @map("user_id")
 @@map("users")
 ```

package/templates/nextjs/docs/library/prisma/setup.md

@@ -1,6 +1,6 @@
-# Prisma - Installation and Setup
+# Prisma - 설치 및 설정
 
-## Installation
+## 설치
 
 ```bash
 yarn add @prisma/client@7
@@ -8,15 +8,15 @@ yarn add -D prisma@7
 npx prisma init
 ```
 
-## v6 → v7 Upgrade
+## v6 → v7 업그레이드
 
 ```prisma
-// v6 (old)
+// v6 (이전)
 generator client {
   provider = "prisma-client-js"
 }
 
-// v7 (required)
+// v7 (필수)
 generator client {
   provider = "prisma-client"
   output   = "../generated/prisma"
@@ -34,7 +34,7 @@ export const prisma = globalForPrisma.prisma ?? new PrismaClient({ log: ['query'
 if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma
 ```
 
-## TanStack Start Integration
+## TanStack Start 연동
 
 ```typescript
 import { createServerFn } from '@tanstack/react-start'

package/templates/nextjs/docs/library/prisma/transactions.md

@@ -1,8 +1,8 @@
-# Prisma - Transactions
+# Prisma - 트랜잭션
 
-## Array-based Transaction
+## 배열 기반 트랜잭션
 
-Rolls back all if any operation fails.
+하나라도 실패하면 모두 롤백.
 
 ```typescript
 const deletePosts = prisma.post.deleteMany({ where: { authorId: 7 } })
@@ -10,9 +10,9 @@ const deleteUser = prisma.user.delete({ where: { id: 7 } })
 await prisma.$transaction([deletePosts, deleteUser])
 ```
 
-## Interactive Transaction
+## 인터랙티브 트랜잭션
 
-For complex logic and conditional processing.
+복잡한 로직, 조건부 처리.
 
 ```typescript
 const result = await prisma.$transaction(async (tx) => {
@@ -26,17 +26,17 @@ const result = await prisma.$transaction(async (tx) => {
 })
 ```
 
-## Options
+## 옵션
 
 ```typescript
 await prisma.$transaction(async (tx) => { ... }, {
-  maxWait: 5000,              // maximum wait time (ms)
-  timeout: 10000,             // timeout (ms)
+  maxWait: 5000,              // 최대 대기 (ms)
+  timeout: 10000,             // 타임아웃 (ms)
   isolationLevel: 'Serializable',  // ReadUncommitted | ReadCommitted | RepeatableRead | Serializable
 })
 ```
 
-## Error Handling
+## 에러 처리
 
 ```typescript
 try {
@@ -45,6 +45,6 @@ try {
     if (someCondition) throw new Error('Rollback')
   })
 } catch (error) {
-  // entire transaction rolled back
+  // 전체 롤백됨
 }
 ```

package/templates/nextjs/docs/library/tanstack-query/index.md

@@ -40,12 +40,12 @@ const mutation = useMutation({
   },
 })
 
-// Setup
+// 설정
 const queryClient = new QueryClient({
   defaultOptions: {
     queries: {
-      staleTime: 1000 * 60 * 5,   // 5 minutes
-      gcTime: 1000 * 60 * 30,     // 30 minutes
+      staleTime: 1000 * 60 * 5,   // 5분
+      gcTime: 1000 * 60 * 30,     // 30분
       retry: 3,
     },
   },
@@ -58,9 +58,9 @@ const App = () => (
 )
 
 // Query Keys
-['todos']                       // simple
-['todo', { id: 5 }]             // with parameter
-['todos', 'list', { filters }]  // hierarchical
+['todos']                       // 단순
+['todo', { id: 5 }]             // 파라미터
+['todos', 'list', { filters }]  // 계층적
 ```
 
 </quick_reference>

package/templates/nextjs/docs/library/tanstack-query/invalidation.md

@@ -1,54 +1,54 @@
-# TanStack Query - Query Invalidation
+# TanStack Query - Query 무효화
 
 <patterns>
 
 ```typescript
 const queryClient = useQueryClient()
 
-// Single
+// 단일
 queryClient.invalidateQueries({ queryKey: ['todos'] })
 
-// Multiple
+// 다중
 await Promise.all([
   queryClient.invalidateQueries({ queryKey: ['todos'] }),
   queryClient.invalidateQueries({ queryKey: ['reminders'] }),
 ])
 
-// All
+// 전체
 queryClient.invalidateQueries()
 
-// Options
+// 옵션
 queryClient.invalidateQueries({
   queryKey: ['posts'],
-  exact: true,  // exact key match only
+  exact: true,  // 정확한 키 매칭만
   refetchType: 'active',  // 'active' | 'inactive' | 'all' | 'none'
 })
 
-// Query key matching
-queryClient.invalidateQueries({ queryKey: ['todos'] })  // prefix matching
-queryClient.invalidateQueries({ queryKey: ['todos', 'list'], exact: true })  // exact matching
+// Query Key 매칭
+queryClient.invalidateQueries({ queryKey: ['todos'] })  // prefix 매칭
+queryClient.invalidateQueries({ queryKey: ['todos', 'list'], exact: true })  // 정확한 매칭
 
-// With mutation
+// Mutation과 함께
 useMutation({
   mutationFn: addTodo,
   onSuccess: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),
-  onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),  // regardless of success/failure
+  onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),  // 성공/실패 무관
 })
 
-// Direct update vs invalidation
-queryClient.setQueryData(['todos'], (old) => [...old, newTodo])  // faster
-queryClient.invalidateQueries({ queryKey: ['todos'] })  // guarantees server data
+// 직접 업데이트 vs 무효화
+queryClient.setQueryData(['todos'], (old) => [...old, newTodo])  // 더 빠름
+queryClient.invalidateQueries({ queryKey: ['todos'] })  // 서버 데이터 보장
 ```
 
 </patterns>
 
 <options>
 
-| refetchType | Description |
-|-------------|-------------|
-| active | Refetch only queries currently being rendered (default) |
-| inactive | Refetch only inactive queries |
-| all | Refetch all matching queries |
-| none | Invalidate only, no refetch |
+| refetchType | 설명 |
+|-------------|------|
+| active | 렌더링 중인 쿼리만 재조회 (기본) |
+| inactive | 비활성 쿼리만 |
+| all | 모든 매칭 쿼리 |
+| none | 무효화만, 재조회 안함 |
 
 </options>

package/templates/nextjs/docs/library/tanstack-query/optimistic-updates.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// Add
+// 추가
 useMutation({
   mutationFn: addTodo,
   onMutate: async (newTodo) => {
@@ -20,7 +20,7 @@ useMutation({
   },
 })
 
-// Delete
+// 삭제
 useMutation({
   mutationFn: deleteTodo,
   onMutate: async (todoId) => {
@@ -37,7 +37,7 @@ useMutation({
   onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),
 })
 
-// Toggle
+// 토글
 useMutation({
   mutationFn: toggleTodo,
   onMutate: async (todoId) => {
@@ -56,7 +56,7 @@ useMutation({
   onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),
 })
 
-// Single item
+// 단일 항목
 useMutation({
   mutationFn: updateTodo,
   onMutate: async (newTodo) => {

package/templates/nextjs/docs/library/tanstack-query/use-mutation.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// Basic
+// 기본
 const queryClient = useQueryClient()
 const mutation = useMutation({
   mutationFn: postTodo,
@@ -11,12 +11,12 @@ const mutation = useMutation({
 })
 mutation.mutate({ title: 'New Todo' })
 
-// Callbacks
+// 콜백
 useMutation({
   mutationFn: updateTodo,
   onMutate: async (newTodo) => {
-    // before mutation starts (for optimistic updates)
-    return { previousData }  // passed to context
+    // mutation 시작 전 (optimistic update용)
+    return { previousData }  // context로 전달
   },
   onSuccess: (data, variables, context) => {},
   onError: (error, variables, context) => {},
@@ -35,7 +35,7 @@ try {
   const result = await mutation.mutateAsync(data)
 } catch (error) { ... }
 
-// Cache update
+// 캐시 업데이트
 useMutation({
   mutationFn: patchTodo,
   onSuccess: (data) => {
@@ -49,15 +49,15 @@ useMutation({
 
 <returns>
 
-| Property | Description |
-|----------|-------------|
-| data | Mutation result |
-| error | Error object |
-| isPending | Execution in progress |
-| isSuccess/isError | Status flags |
-| mutate | Execute (async) |
-| mutateAsync | Execute (Promise) |
-| reset | Reset state |
-| variables | Passed variables |
+| 속성 | 설명 |
+|------|------|
+| data | mutation 결과 |
+| error | 에러 객체 |
+| isPending | 실행 중 |
+| isSuccess/isError | 상태 |
+| mutate | 실행 (비동기) |
+| mutateAsync | 실행 (Promise) |
+| reset | 상태 초기화 |
+| variables | 전달된 변수 |
 
 </returns>

package/templates/nextjs/docs/library/tanstack-query/use-query.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// Basic
+// 기본
 const { data, isLoading, error } = useQuery({
   queryKey: ['todos'],
   queryFn: getTodos,
@@ -11,28 +11,28 @@ const { data, isLoading, error } = useQuery({
 if (isLoading) return <div>Loading...</div>
 if (error) return <div>Error: {error.message}</div>
 
-// Options
+// 옵션
 useQuery({
   queryKey: ['todos'],
   queryFn: fetchTodos,
-  staleTime: 1000 * 60 * 5,      // time to keep data fresh
-  gcTime: 1000 * 60 * 30,        // garbage collection time
-  refetchOnWindowFocus: true,    // refetch on window focus
-  refetchInterval: 1000 * 60,    // auto-refetch interval
-  retry: 3,                      // retry attempts
-  enabled: !!userId,             // conditional execution
-  initialData: [],               // initial data
-  select: (data) => data.filter(t => t.done),  // data transformation
+  staleTime: 1000 * 60 * 5,      // fresh 유지 시간
+  gcTime: 1000 * 60 * 30,        // 가비지 컬렉션 시간
+  refetchOnWindowFocus: true,    // 포커스 시 리페치
+  refetchInterval: 1000 * 60,    // 자동 리페치 간격
+  retry: 3,                      // 재시도 횟수
+  enabled: !!userId,             // 조건부 실행
+  initialData: [],               // 초기 데이터
+  select: (data) => data.filter(t => t.done),  // 데이터 변환
 })
 
-// With parameter
+// 파라미터
 useQuery({
   queryKey: ['todo', todoId],
   queryFn: () => fetchTodoById(todoId),
   enabled: !!todoId,
 })
 
-// Dependent queries
+// 의존적 쿼리
 const { data: user } = useQuery({ queryKey: ['user', userId], queryFn: ... })
 const { data: posts } = useQuery({
   queryKey: ['posts', user?.id],
@@ -40,11 +40,11 @@ const { data: posts } = useQuery({
   enabled: !!user?.id,
 })
 
-// Parallel
+// 병렬
 const usersQuery = useQuery({ queryKey: ['users'], queryFn: fetchUsers })
 const postsQuery = useQuery({ queryKey: ['posts'], queryFn: fetchPosts })
 
-// Dynamic parallel
+// 동적 병렬
 const userQueries = useQueries({
   queries: userIds.map((id) => ({
     queryKey: ['user', id],
@@ -57,14 +57,14 @@ const userQueries = useQueries({
 
 <returns>
 
-| Property | Description |
-|----------|-------------|
-| data | Query result |
-| error | Error object |
-| isLoading | First loading state |
-| isFetching | Background fetching state |
-| isError/isSuccess | Status flags |
-| refetch | Manual refetch function |
+| 속성 | 설명 |
+|------|------|
+| data | 쿼리 결과 |
+| error | 에러 객체 |
+| isLoading | 첫 로딩 중 |
+| isFetching | 백그라운드 페칭 중 |
+| isError/isSuccess | 상태 |
+| refetch | 수동 리페치 |
 | status | 'pending' \| 'error' \| 'success' |
 
 </returns>

package/templates/nextjs/docs/library/zod/complex-types.md

@@ -1,31 +1,31 @@
-# Zod - Complex Types
+# Zod - 복합 타입
 
 <patterns>
 
 ```typescript
-// Object
+// 객체
 const UserSchema = z.object({
   name: z.string(),
   email: z.email(),
   age: z.number().optional(),
 })
 
-UserSchema.partial()              // all fields optional
-UserSchema.required()             // all fields required
-UserSchema.pick({ name: true })   // specific fields only
-UserSchema.omit({ email: true })  // exclude specific fields
+UserSchema.partial()              // 모든 필드 optional
+UserSchema.required()             // 모든 필드 required
+UserSchema.pick({ name: true })   // 특정 필드만
+UserSchema.omit({ email: true })  // 특정 필드 제외
 UserSchema.extend({ role: z.enum(['admin', 'user']) })
 UserSchema.merge(AnotherSchema)
 
-z.strictObject({ name: z.string() })  // v4: additional keys throw error
-z.looseObject({ name: z.string() })   // v4: additional keys pass through
+z.strictObject({ name: z.string() })  // v4: 추가 키 에러
+z.looseObject({ name: z.string() })   // v4: 추가 키 통과
 
-// Array/Tuple
+// 배열/튜플
 z.array(z.string())
 z.array(z.number()).min(1).max(10).length(5).nonempty()
 z.tuple([z.string(), z.number()])  // [string, number]
 
-// Union
+// 유니온
 z.union([z.string(), z.number()])
 z.string().or(z.number())
 
@@ -46,7 +46,7 @@ z.record(z.string(), z.object({ name: z.string() }))  // { [key: string]: { name
 z.map(z.string(), z.number())  // Map<string, number>
 z.set(z.number())              // Set<number>
 
-// Recursive
+// 재귀
 type Json = string | number | boolean | null | { [key: string]: Json } | Json[]
 
 const jsonSchema: z.ZodType<Json> = z.lazy(() =>

package/templates/nextjs/docs/library/zod/index.md

@@ -11,7 +11,7 @@
 <quick_reference>
 
 ```typescript
-// Basic
+// 기본
 const schema = z.object({
   email: z.email(),              // v4!
   name: z.string().min(1).trim(),
@@ -20,7 +20,7 @@ const schema = z.object({
 })
 type Input = z.infer<typeof schema>
 
-schema.parse(data)              // throws on failure
+schema.parse(data)              // 실패 시 throw
 schema.safeParse(data)          // { success, data/error }
 
 // TanStack Start
@@ -34,7 +34,7 @@ export const createUser = createServerFn({ method: 'POST' })
 <v4_changes>
 
 ```typescript
-// ✅ v4 new APIs
+// ✅ v4 새 API
 z.email()  z.url()  z.uuid()
 z.iso.date()  z.iso.datetime()  z.iso.duration()
 z.stringbool()  // "true"/"yes"/"1" → true
@@ -42,13 +42,13 @@ z.stringbool()  // "true"/"yes"/"1" → true
 // ❌ v3 deprecated
 z.string().email()  z.string().url()
 
-// Changes
+// 변경사항
 z.string().min(5, { error: "Too short." })  // message → error
-z.strictObject({ name: z.string() })  // additional keys throw error
-z.looseObject({ name: z.string() })   // additional keys pass through
-z.string().refine(val => val.includes("@")).min(5)  // refinement chaining
+z.strictObject({ name: z.string() })  // 추가 키 에러
+z.looseObject({ name: z.string() })   // 추가 키 통과
+z.string().refine(val => val.includes("@")).min(5)  // refinement 체이닝
 
-// Template literals
+// 템플릿 리터럴
 const css = z.templateLiteral([z.number(), z.enum(["px", "em", "rem"])])
 // `${number}px` | `${number}em` | `${number}rem`
 ```

package/templates/nextjs/docs/library/zod/transforms.md

@@ -1,4 +1,4 @@
-# Zod - Transforms
+# Zod - 변환
 
 <patterns>
 
@@ -10,7 +10,7 @@ stringToLength.parse('hello')  // => 5
 type In = z.input<typeof stringToLength>   // string
 type Out = z.output<typeof stringToLength> // number
 
-// Pipe (validate then transform)
+// Pipe (검증 후 변환)
 const stringToNumber = z.string()
   .transform((val) => parseInt(val, 10))
   .pipe(z.number().min(0).max(100))
@@ -18,20 +18,20 @@ const stringToNumber = z.string()
 stringToNumber.parse('50')  // => 50
 stringToNumber.parse('150') // throws
 
-// Coerce (force conversion)
-z.coerce.string()   // any value → string
-z.coerce.number()   // any value → number
-z.coerce.boolean()  // any value → boolean
-z.coerce.date()     // any value → date
-z.coerce.bigint()   // any value → BigInt
+// Coerce (강제 변환)
+z.coerce.string()   // 모든 값 → 문자열
+z.coerce.number()   // 모든 값 → 숫자
+z.coerce.boolean()  // 모든 값 → 불리언
+z.coerce.date()     // 모든 값 → 날짜
+z.coerce.bigint()   // 모든 값 → BigInt
 
 z.coerce.number().parse("42")  // => 42
 z.coerce.date().parse("2021-01-01")  // => Date
 
-// v4: input type changed to unknown
+// v4: 입력 타입이 unknown으로 변경
 type In = z.input<typeof z.coerce.string()>  // unknown
 
-// v4 environment variable boolean
+// v4 환경변수 불리언
 z.stringbool()  // "true"/"yes"/"1" → true, "false"/"no"/"0" → false
 
 // Preprocess
@@ -40,7 +40,7 @@ const trimmed = z.preprocess(
   z.string()
 )
 
-// Separate input/output types
+// 입력/출력 타입 분리
 const Schema = z.object({
   createdAt: z.string().transform((str) => new Date(str)),
 })