@kood/claude-code 0.5.3 → 0.5.5

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

@@ -9,7 +9,7 @@
 <Link to="/products" search={{ page: 1, sort: 'newest' }}>Products</Link>
 <Link to="/products" search={prev => ({ ...prev, page: 2 })}>Next</Link>
 
-// Active styles
+// Active 스타일
 <Link
   to="/about"
   activeProps={{ className: 'text-blue-500 font-bold' }}
@@ -33,11 +33,11 @@ const Component = () => {
 }
 
 // Preloading
-<Link to="/posts" preload="intent">Posts</Link>       // On hover
-<Link to="/dashboard" preload="render">Dash</Link>    // On render
-<Link to="/products" preload="viewport">Prod</Link>   // On viewport entry
+<Link to="/posts" preload="intent">Posts</Link>       // hover 시
+<Link to="/dashboard" preload="render">Dash</Link>    // 렌더링 시
+<Link to="/products" preload="viewport">Prod</Link>   // viewport 진입 시
 
-// Conditional navigation
+// 조건부 네비게이션
 const SubmitButton = () => {
   const navigate = useNavigate()
   const [isPending, startTransition] = useTransition()
@@ -57,24 +57,24 @@ const SubmitButton = () => {
 
 <options>
 
-| Link Props | Type | Description |
+| Link Props | 타입 | 설명 |
 |------------|------|------|
-| `to` | string | Destination path |
-| `params` | object | Path parameters |
+| `to` | string | 목적지 경로 |
+| `params` | object | Path 파라미터 |
 | `search` | object \| function | Search params |
 | `hash` | string | Hash |
-| `replace` | boolean | Use history replace |
-| `preload` | 'intent' \| 'render' \| 'viewport' | Preload strategy |
-| `activeProps` | object | Props when active |
-| `inactiveProps` | object | Props when inactive |
+| `replace` | boolean | history replace |
+| `preload` | 'intent' \| 'render' \| 'viewport' | Preload 전략 |
+| `activeProps` | object | Active 시 props |
+| `inactiveProps` | object | Inactive 시 props |
 
-| navigate Options | Type | Description |
+| navigate 옵션 | 타입 | 설명 |
 |---------------|------|------|
-| `to` | string | Destination path |
-| `params` | object | Path parameters |
+| `to` | string | 목적지 경로 |
+| `params` | object | Path 파라미터 |
 | `search` | object \| function | Search params |
 | `hash` | string | Hash |
-| `replace` | boolean | Use history.replace |
-| `resetScroll` | boolean | Reset scroll |
+| `replace` | boolean | history.replace 사용 |
+| `resetScroll` | boolean | 스크롤 리셋 |
 
 </options>

package/templates/tanstack-start/docs/library/tanstack-router/route-context.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// beforeLoad: auth check + add context
+// beforeLoad: 인증 체크 + context 추가
 export const Route = createFileRoute('/dashboard')({
   beforeLoad: async ({ context, location }) => {
     if (!context.auth.isAuthenticated) {
@@ -30,7 +30,7 @@ export const Route = createFileRoute('/_authed/dashboard')({
   component: DashboardPage,
 })
 const DashboardPage = () => {
-  const { user } = Route.useRouteContext()  // Context from _authed
+  const { user } = Route.useRouteContext()  // _authed에서 전달된 context
   return <h1>Welcome, {user.name}!</h1>
 }
 
@@ -75,10 +75,10 @@ routes/
 
 <usage>
 
-| Location | Access Method |
+| 위치 | 접근 방법 |
 |------|----------|
-| beforeLoad | `{ context }` parameter |
-| loader | `{ context }` parameter |
+| beforeLoad | `{ context }` 파라미터 |
+| loader | `{ context }` 파라미터 |
 | component | `Route.useRouteContext()` |
 
 </usage>

package/templates/tanstack-start/docs/library/tanstack-router/search-params.md

@@ -3,20 +3,20 @@
 <patterns>
 
 ```tsx
-// Zod schema + route
+// Zod 스키마 + 라우트
 const searchSchema = z.object({
-  page: z.number().catch(1),            // Default value
-  search: z.string().optional(),        // Optional
+  page: z.number().catch(1),            // 기본값
+  search: z.string().optional(),        // 선택
   sort: z.enum(['newest', 'price']).catch('newest'),
-  tags: z.array(z.string()).catch([]),  // Array
+  tags: z.array(z.string()).catch([]),  // 배열
   inStock: z.boolean().catch(true),     // Boolean
-  from: z.string().date().optional(),   // Date
-  minPrice: z.number().min(0).catch(0), // Range
+  from: z.string().date().optional(),   // 날짜
+  minPrice: z.number().min(0).catch(0), // 범위
 })
 
 export const Route = createFileRoute('/products')({
   validateSearch: searchSchema,
-  loaderDeps: ({ search }) => ({ search }),  // Re-run loader on search change
+  loaderDeps: ({ search }) => ({ search }),  // search 변경 시 loader 재실행
   loader: async ({ deps: { search } }) => fetchProducts(search),
   component: ProductsPage,
 })
@@ -26,11 +26,11 @@ const ProductsPage = () => {
   return <div>Page: {page}, Sort: {sort}</div>
 }
 
-// Update via Link
+// Link로 업데이트
 <Link to="/products" search={{ page: 1, sort: 'newest' }}>Reset</Link>
 <Link to="/products" search={prev => ({ ...prev, page: 2 })}>Next</Link>
 
-// Update via useNavigate
+// useNavigate로 업데이트
 const Pagination = () => {
   const navigate = useNavigate()
   const { page } = Route.useSearch()
@@ -48,7 +48,7 @@ const Pagination = () => {
   )
 }
 
-// Real-world: Filter + Sort + Pagination
+// 실전: 필터 + 정렬 + 페이지네이션
 const PostsPage = () => {
   const { page, search, category, sort } = Route.useSearch()
   const posts = Route.useLoaderData()

package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md

@@ -1,9 +1,9 @@
-# TanStack Start - Auth Patterns
+# TanStack Start - 인증 패턴
 
 <patterns>
 
 ```typescript
-// Login
+// 로그인
 export const loginFn = createServerFn({ method: 'POST' })
   .inputValidator((data: { email: string; password: string }) => data)
   .handler(async ({ data }) => {
@@ -14,7 +14,7 @@ export const loginFn = createServerFn({ method: 'POST' })
     throw redirect({ to: '/dashboard' })
   })
 
-// Logout
+// 로그아웃
 export const logoutFn = createServerFn({ method: 'POST' })
   .handler(async () => {
     const session = await useAppSession()
@@ -22,7 +22,7 @@ export const logoutFn = createServerFn({ method: 'POST' })
     throw redirect({ to: '/' })
   })
 
-// Get current user
+// 현재 사용자
 export const getCurrentUserFn = createServerFn({ method: 'GET' })
   .handler(async () => {
     const session = await useAppSession()
@@ -30,7 +30,7 @@ export const getCurrentUserFn = createServerFn({ method: 'GET' })
     return getUserById(session.data.userId)
   })
 
-// Auth middleware
+// 인증 미들웨어
 export const authMiddleware = createMiddleware({ type: 'function' })
   .server(async ({ next }) => {
     const session = await useAppSession()
@@ -39,12 +39,12 @@ export const authMiddleware = createMiddleware({ type: 'function' })
     return next({ context: { user } })
   })
 
-// Apply to Server Function
+// Server Function에 적용
 export const protectedFn = createServerFn({ method: 'GET' })
   .middleware([authMiddleware])
   .handler(async ({ context }) => ({ user: context.user }))
 
-// Protected route
+// 보호된 라우트
 export const Route = createFileRoute('/dashboard')({
   beforeLoad: async () => {
     const user = await getCurrentUserFn()
@@ -57,7 +57,7 @@ export const Route = createFileRoute('/dashboard')({
   },
 })
 
-// Better Auth integration
+// Better Auth 통합
 export const auth = betterAuth({
   database: prismaAdapter(prisma),
   emailAndPassword: { enabled: true },

package/templates/tanstack-start/docs/library/tanstack-start/middleware.md

@@ -1,24 +1,24 @@
 # TanStack Start - Middleware
 
-Apply common logic to Server Functions and routes.
+Server Function 및 라우트에 공통 로직 적용.
 
-## Basic Pattern
+## 기본 패턴
 
 ```typescript
-// Middleware definition
+// 미들웨어 정의
 const loggingMiddleware = createMiddleware({ type: 'function' })
   .server(({ next }) => {
     console.log('Processing request')
     return next()
   })
 
-// Apply
+// 적용
 const fn = createServerFn()
   .middleware([loggingMiddleware])
   .handler(async () => ({ message: 'Hello' }))
 ```
 
-## Auth Middleware
+## 인증 미들웨어
 
 ```typescript
 const authMiddleware = createMiddleware({ type: 'function' })
@@ -28,7 +28,7 @@ const authMiddleware = createMiddleware({ type: 'function' })
     return next({ context: { user: session.user } })
   })
 
-// Usage
+// 사용
 export const protectedFn = createServerFn({ method: 'GET' })
   .middleware([authMiddleware])
   .handler(async ({ context }) => ({ user: context.user }))
@@ -47,8 +47,8 @@ const workspaceMiddleware = createMiddleware({ type: 'function' })
 ```typescript
 // src/start.ts
 export const startInstance = createStart(() => ({
-  requestMiddleware: [globalMiddleware],  // All requests
-  functionMiddleware: [loggingMiddleware], // All Server Functions
+  requestMiddleware: [globalMiddleware],  // 모든 요청
+  functionMiddleware: [loggingMiddleware], // 모든 Server Function
 }))
 ```
 
@@ -57,7 +57,7 @@ export const startInstance = createStart(() => ({
 ```typescript
 export const Route = createFileRoute('/hello')({
   server: {
-    middleware: [authMiddleware], // All handlers
+    middleware: [authMiddleware], // 모든 핸들러
     handlers: { GET: async ({ request }) => new Response('Hello') },
   },
 })

package/templates/tanstack-start/docs/library/tanstack-start/routing.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// Basic
+// 기본
 export const Route = createFileRoute('/about')({ component: AboutPage })
 
 // Loader
@@ -16,7 +16,7 @@ const Page = () => {
   return <ul>{posts.map(p => <li key={p.id}>{p.title}</li>)}</ul>
 }
 
-// Dynamic routes
+// 동적 라우트
 export const Route = createFileRoute('/users/$id')({
   loader: async ({ params }) => ({ user: await getUserById(params.id) }),
   component: () => {
@@ -25,10 +25,10 @@ export const Route = createFileRoute('/users/$id')({
   },
 })
 
-// SSR options
-ssr: true       // Full SSR (default)
-ssr: false      // Client-only
-ssr: 'data-only' // Data only on server
+// SSR 옵션
+ssr: true       // 전체 SSR (기본값)
+ssr: false      // 클라이언트만
+ssr: 'data-only' // 데이터만 서버
 
 // Server Routes (API)
 export const Route = createFileRoute('/api/hello')({

package/templates/tanstack-start/docs/library/tanstack-start/server-functions.md

@@ -1,13 +1,13 @@
 # TanStack Start - Server Functions
 
-Type-safe functions that run only on the server.
+서버에서만 실행되는 타입 안전한 함수.
 
-## ⚠️ Required: Use TanStack Query
+## ⚠️ 필수: TanStack Query 사용
 
-Always use useQuery/useMutation when calling from client.
-- Auto caching, deduplication, loading/error states, invalidateQueries sync
+클라이언트 호출 시 반드시 useQuery/useMutation 사용.
+- 자동 캐싱, 중복 요청 제거, 로딩/에러 상태 관리, invalidateQueries 동기화
 
-## Basic Patterns
+## 기본 패턴
 
 ```typescript
 // GET
@@ -25,31 +25,31 @@ export const createUser = createServerFn({ method: 'POST' })
   .handler(async ({ data }) => prisma.user.create({ data }))
 ```
 
-## Calling from Components
+## 컴포넌트에서 호출
 
 ```tsx
-// ✅ useQuery (read)
+// ✅ useQuery (조회)
 const { data, isLoading } = useQuery({
   queryKey: ['posts'],
   queryFn: () => getServerPosts(),
 })
 
-// ✅ useMutation (write)
+// ✅ useMutation (변경)
 const mutation = useMutation({
   mutationFn: createPost,
   onSuccess: () => queryClient.invalidateQueries({ queryKey: ['posts'] }),
 })
 
-// ❌ Direct calls forbidden (no caching, no sync)
+// ❌ 직접 호출 금지 (캐싱 없음, 동기화 안됨)
 ```
 
-## Function Separation Rules
+## 함수 분리 규칙
 
 ```typescript
-// Internal helper (don't export!)
+// 내부 헬퍼 (export 금지!)
 const validateUserData = async (email: string) => { ... }
 
-// Server Function (exportable)
+// Server Function (export 가능)
 export const createUser = createServerFn({ method: 'POST' })
   .inputValidator(createUserSchema)
   .handler(async ({ data }) => {
@@ -57,19 +57,19 @@ export const createUser = createServerFn({ method: 'POST' })
     return prisma.user.create({ data })
   })
 
-// index.ts: Export only Server Functions
+// index.ts: Server Function만 export
 export { createUser } from './mutations'
-// ❌ export { validateUserData } forbidden
+// ❌ export { validateUserData } 금지
 ```
 
-## Security
+## 보안
 
 ```tsx
-// ❌ Environment variables in loader (exposed)
+// ❌ loader에서 환경변수 직접 사용 (노출됨)
 loader: () => { const secret = process.env.SECRET }
 
-// ✅ Use Server Functions
+// ✅ Server Function 사용
 const fn = createServerFn().handler(() => {
-  const secret = process.env.SECRET // server-only
+  const secret = process.env.SECRET // 서버에서만
 })
 ```

package/templates/tanstack-start/docs/library/tanstack-start/setup.md

@@ -1,13 +1,13 @@
-# TanStack Start - Installation and Setup
+# TanStack Start - 설치 및 설정
 
-## Installation
+## 설치
 
 ```bash
 yarn add @tanstack/react-start @tanstack/react-router vinxi
 yarn add -D vite @vitejs/plugin-react vite-tsconfig-paths
 ```
 
-## Configuration
+## 설정
 
 ```typescript
 // vite.config.ts
@@ -36,7 +36,7 @@ export default defineConfig({
 }
 ```
 
-## Environment Variable Validation
+## 환경 변수 검증
 
 ```typescript
 // lib/env.ts

package/templates/tanstack-start/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 })   // Only specific fields
-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: error on extra keys
-z.looseObject({ name: z.string() })   // v4: allow extra keys
+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/tanstack-start/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 → string
-z.coerce.number()   // any → number
-z.coerce.boolean()  // any → boolean
-z.coerce.date()     // any → Date
-z.coerce.bigint()   // any → 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 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)),
 })

package/templates/tanstack-start/docs/library/zod/validation.md

@@ -1,4 +1,4 @@
-# Zod - Validation
+# Zod - 검증
 
 <patterns>
 
@@ -6,10 +6,10 @@
 // Refinement (v4: message → error)
 const PasswordSchema = z.string()
   .min(8)
-  .refine((val) => /[A-Z]/.test(val), { error: 'Uppercase required' })
-  .refine((val) => /[0-9]/.test(val), { error: 'Number required' })
+  .refine((val) => /[A-Z]/.test(val), { error: '대문자 필수' })
+  .refine((val) => /[0-9]/.test(val), { error: '숫자 필수' })
 
-z.string().refine(val => val.includes("@")).min(5)  // v4: chaining after refinement
+z.string().refine(val => val.includes("@")).min(5)  // v4: refinement 후 체이닝
 
 // Async
 const schema = z.string().refine(async (val) => val.length <= 8)
@@ -23,20 +23,20 @@ z.object({
   if (data.password !== data.confirmPassword) {
     ctx.addIssue({
       code: z.ZodIssueCode.custom,
-      message: 'Passwords do not match',
+      message: '비밀번호 불일치',
       path: ['confirmPassword'],
     })
   }
-})  // v4: ctx.path cannot be used
+})  // v4: ctx.path 사용 불가
 
-// Custom
+// 커스텀
 const px = z.custom<`${number}px`>((val) =>
   typeof val === 'string' && /^\d+px$/.test(val)
 )
 px.parse('42px')  // ✅
 px.parse('42vw')  // throws
 
-// Error handling
+// 에러 처리
 const result = schema.safeParse(data)
 if (!result.success) {
   result.error.errors.forEach((err) => {
@@ -50,7 +50,7 @@ export const createUser = createServerFn({ method: 'POST' })
   .inputValidator(zodValidator(createUserSchema))
   .handler(async ({ data }) => prisma.user.create({ data }))
 
-// Environment variables
+// 환경 변수
 const env = z.object({
   NODE_ENV: z.enum(['development', 'production', 'test']),
   DATABASE_URL: z.string().url(),