@kood/claude-code 0.5.4 → 0.5.5

package/templates/tanstack-start/docs/library/prisma/relations.md

@@ -1,6 +1,6 @@
-# Prisma - Relation Queries
+# Prisma - 관계 쿼리
 
-## Nested Create
+## 중첩 생성
 
 ```typescript
 const user = await prisma.user.create({
@@ -12,53 +12,53 @@ const user = await prisma.user.create({
 })
 ```
 
-## Relation Operations
+## 관계 연결
 
 ```typescript
-// connect - Link existing record
+// connect - 기존 연결
 author: { connect: { id: 1 } }
 
-// connectOrCreate - Connect if exists, create otherwise
+// connectOrCreate - 있으면 연결, 없으면 생성
 categories: { connectOrCreate: { where: { name: 'Tech' }, create: { name: 'Tech' } } }
 
-// disconnect - Remove relation
+// disconnect - 관계 해제
 author: { disconnect: true }
 ```
 
-## Include Relations
+## 관계 포함 조회
 
 ```typescript
 // include
 const users = await prisma.user.findMany({ include: { posts: true, profile: true } })
 
-// Nested
+// 중첩
 include: { posts: { include: { categories: true } } }
 
-// Filter + Sort
+// 필터 + 정렬
 include: { posts: { where: { published: true }, orderBy: { createdAt: 'desc' }, take: 5 } }
 ```
 
-## Filter by Relations
+## 관계로 필터링
 
 ```typescript
-// some - At least one matches
+// some - 하나라도 만족
 where: { posts: { some: { published: true } } }
 
-// every - All match
+// every - 모두 만족
 where: { posts: { every: { published: true } } }
 
-// none - None match
+// none - 만족 없음
 where: { posts: { none: { published: false } } }
 ```
 
-## Count
+## 카운트
 
 ```typescript
 include: { _count: { select: { posts: true } } }
-// Result: { _count: { posts: 5 } }
+// 결과: { _count: { posts: 5 } }
 ```
 
-## Nested Update/Delete
+## 중첩 수정/삭제
 
 ```typescript
 // updateMany

package/templates/tanstack-start/docs/library/prisma/schema.md

@@ -1,21 +1,21 @@
-# Prisma - Schema Definition (Multi-File)
+# Prisma - 스키마 정의 (Multi-File)
 
-## ⚠️ Required Rules
+## ⚠️ 필수 규칙
 
-1. **Multi-File structure** required
-2. **Korean comments on 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 모델
 ```
 
-## Examples
+## 예시
 
 ```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[]            // Author posts (1:N)
-  profile   Profile?          // 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 {
 }
 ```
 
-## Other Features
+## 기타
 
 ```prisma
-// Optional relation
+// 선택적 관계
 author   User? @relation(fields: [authorId], references: [id])
 authorId Int?
 
-// Indexes
+// 인덱스
 @@index([authorId])
 @@index([createdAt])
 
-// Composite key
+// 복합 키
 @@id([postId, tagId])
 
-// Mapping
+// 매핑
 @map("user_id")
 @@map("users")
 ```

package/templates/tanstack-start/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/tanstack-start/docs/library/prisma/transactions.md

@@ -1,8 +1,8 @@
-# Prisma - Transactions
+# Prisma - 트랜잭션
 
-## Array-based Transactions
+## 배열 기반 트랜잭션
 
-All operations rollback if any one 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 Transactions
+## 인터랙티브 트랜잭션
 
-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,              // Max 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/tanstack-start/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 match
-queryClient.invalidateQueries({ queryKey: ['todos', 'list'], exact: true })  // Exact match
+// 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 |
+| refetchType | 설명 |
 |-------------|------|
-| active | Refetch only active queries (default) |
-| inactive | Only inactive queries |
-| all | All matching queries |
-| none | Invalidate only, no refetch |
+| active | 렌더링 중인 쿼리만 재조회 (기본) |
+| inactive | 비활성 쿼리만 |
+| all | 모든 매칭 쿼리 |
+| none | 무효화만, 재조회 안함 |
 
 </options>

package/templates/tanstack-start/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/tanstack-start/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 | Executing |
-| isSuccess/isError | Status |
-| 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/tanstack-start/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 stay fresh
-  gcTime: 1000 * 60 * 30,        // Garbage collection time
-  refetchOnWindowFocus: true,    // Refetch on focus
-  refetchInterval: 1000 * 60,    // Auto refetch interval
-  retry: 3,                      // Retry count
-  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 parameters
+// 파라미터
 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 | Initial loading |
-| isFetching | Background fetching |
-| isError/isSuccess | Status |
-| refetch | Manual refetch |
+| data | 쿼리 결과 |
+| error | 에러 객체 |
+| isLoading | 첫 로딩 중 |
+| isFetching | 백그라운드 페칭 중 |
+| isError/isSuccess | 상태 |
+| refetch | 수동 리페치 |
 | status | 'pending' \| 'error' \| 'success' |
 
 </returns>

package/templates/tanstack-start/docs/library/tanstack-router/error-handling.md

@@ -48,8 +48,8 @@ export const Route = createRootRoute({
 export const Route = createFileRoute('/posts')({
   loader: async () => fetchPosts(),
   pendingComponent: () => <Spinner />,
-  pendingMs: 200,     // Show after 200ms
-  pendingMinMs: 500,  // Keep for at least 500ms (prevent flicker)
+  pendingMs: 200,     // 200ms 후 표시
+  pendingMinMs: 500,  // 최소 500ms 유지 (깜빡임 방지)
   component: PostsPage,
 })
 
@@ -61,7 +61,7 @@ export const Route = createFileRoute('/$')({
   },
 })
 
-// Error type discrimination
+// 에러 타입 구분
 const CustomError = ({ error, reset }: ErrorComponentProps) => {
   if (error instanceof TypeError && error.message.includes('fetch')) {
     return <div><p>Network error</p><button onClick={reset}>Retry</button></div>
@@ -77,13 +77,13 @@ const CustomError = ({ error, reset }: ErrorComponentProps) => {
 
 <priority>
 
-| Priority | Component | Condition |
+| 우선순위 | 컴포넌트 | 조건 |
 |---------|---------|------|
-| 1 | `errorComponent` | Error thrown in loader/beforeLoad |
-| 2 | `notFoundComponent` | `notFound()` thrown |
-| 3 | `pendingComponent` | Loader executing (after pendingMs) |
-| 4 | `component` | Normal rendering |
+| 1 | `errorComponent` | loader/beforeLoad에서 Error throw |
+| 2 | `notFoundComponent` | `notFound()` throw |
+| 3 | `pendingComponent` | loader 실행 중 (pendingMs 이후) |
+| 4 | `component` | 정상 렌더링 |
 
-Error propagation: Child → Parent (propagates to parent if no errorComponent)
+에러 전파: 하위 → 상위 (errorComponent 없으면 부모로 전파)
 
 </priority>

package/templates/tanstack-start/docs/library/tanstack-router/hooks.md

@@ -5,7 +5,7 @@
 ```tsx
 // Route-Scoped (Type-safe)
 const PostPage = () => {
-  const { post } = Route.useLoaderData()      // Loader return value
+  const { post } = Route.useLoaderData()      // Loader 반환값
   const { postId } = Route.useParams()        // Path params
   const { page, sort } = Route.useSearch()    // Search params
   const { user } = Route.useRouteContext()    // Route context
@@ -20,10 +20,10 @@ const postMatch = useMatch({ from: '/posts/$postId', shouldThrow: false })
 if (postMatch) return <span>Post: {postMatch.params.postId}</span>
 
 const { postId } = useParams({ from: '/posts/$postId' })
-const params = useParams({ strict: false })  // All params
+const params = useParams({ strict: false })  // 모든 params
 
 const { page } = useSearch({ from: '/products' })
-const search = useSearch({ strict: false })  // Current search
+const search = useSearch({ strict: false })  // 현재 search
 
 const pathname = useRouterState({ select: state => state.location.pathname })
 const isLoading = useRouterState({ select: state => state.isLoading })
@@ -37,17 +37,17 @@ console.log(location.search)    // { page: 1 }
 
 <reference>
 
-| Hook | Scope | Type | Purpose |
+| Hook | Scope | Type | 용도 |
 |------|-------|------|------|
-| `Route.useLoaderData()` | Route | Auto | Loader data |
+| `Route.useLoaderData()` | Route | Auto | Loader 데이터 |
 | `Route.useParams()` | Route | Auto | Path params |
 | `Route.useSearch()` | Route | Auto | Search params |
 | `Route.useRouteContext()` | Route | Auto | Route context |
-| `useParams({ from })` | Global | Manual | Other route params |
-| `useSearch({ from })` | Global | Manual | Other route search |
-| `useMatch({ from })` | Global | Manual | Route match info |
-| `useNavigate()` | Global | Auto | Navigation |
-| `useRouterState()` | Global | Manual | Router state |
-| `useLocation()` | Global | Auto | Current location |
+| `useParams({ from })` | Global | Manual | 다른 라우트 params |
+| `useSearch({ from })` | Global | Manual | 다른 라우트 search |
+| `useMatch({ from })` | Global | Manual | 라우트 매치 정보 |
+| `useNavigate()` | Global | Auto | 네비게이션 |
+| `useRouterState()` | Global | Manual | 라우터 상태 |
+| `useLocation()` | Global | Auto | 현재 location |
 
 </reference>