@kood/claude-code 0.3.6 → 0.3.8

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) => {
-    // mutation 시작 전 (optimistic update용)
-    return { previousData }  // context로 전달
+    // Before mutation starts (for optimistic updates)
+    return { previousData }  // Passed to 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 결과 |
-| error | 에러 객체 |
-| isPending | 실행 중 |
-| isSuccess/isError | 상태 |
-| mutate | 실행 (비동기) |
-| mutateAsync | 실행 (Promise) |
-| reset | 상태 초기화 |
-| variables | 전달된 변수 |
+| data | Mutation result |
+| error | Error object |
+| isPending | Executing |
+| isSuccess/isError | Status |
+| mutate | Execute (async) |
+| mutateAsync | Execute (Promise) |
+| reset | Reset state |
+| variables | Passed 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,      // fresh 유지 시간
-  gcTime: 1000 * 60 * 30,        // 가비지 컬렉션 시간
-  refetchOnWindowFocus: true,    // 포커스 시 리페치
-  refetchInterval: 1000 * 60,    // 자동 리페치 간격
-  retry: 3,                      // 재시도 횟수
-  enabled: !!userId,             // 조건부 실행
-  initialData: [],               // 초기 데이터
-  select: (data) => data.filter(t => t.done),  // 데이터 변환
+  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
 })
 
-// 파라미터
+// 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 | 쿼리 결과 |
-| error | 에러 객체 |
-| isLoading | 첫 로딩 중 |
-| isFetching | 백그라운드 페칭 중 |
-| isError/isSuccess | 상태 |
-| refetch | 수동 리페치 |
+| data | Query result |
+| error | Error object |
+| isLoading | Initial loading |
+| isFetching | Background fetching |
+| isError/isSuccess | Status |
+| refetch | Manual 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,     // 200ms 후 표시
-  pendingMinMs: 500,  // 최소 500ms 유지 (깜빡임 방지)
+  pendingMs: 200,     // Show after 200ms
+  pendingMinMs: 500,  // Keep for at least 500ms (prevent flicker)
   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` | loader/beforeLoad에서 Error throw |
-| 2 | `notFoundComponent` | `notFound()` throw |
-| 3 | `pendingComponent` | loader 실행 중 (pendingMs 이후) |
-| 4 | `component` | 정상 렌더링 |
+| 1 | `errorComponent` | Error thrown in loader/beforeLoad |
+| 2 | `notFoundComponent` | `notFound()` thrown |
+| 3 | `pendingComponent` | Loader executing (after pendingMs) |
+| 4 | `component` | Normal rendering |
 
-에러 전파: 하위 → 상위 (errorComponent 없으면 부모로 전파)
+Error propagation: Child → Parent (propagates to parent if no 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 반환값
+  const { post } = Route.useLoaderData()      // Loader return value
   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 })  // 모든 params
+const params = useParams({ strict: false })  // All params
 
 const { page } = useSearch({ from: '/products' })
-const search = useSearch({ strict: false })  // 현재 search
+const search = useSearch({ strict: false })  // Current 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 | 용도 |
+| Hook | Scope | Type | Purpose |
 |------|-------|------|------|
-| `Route.useLoaderData()` | Route | Auto | Loader 데이터 |
+| `Route.useLoaderData()` | Route | Auto | Loader data |
 | `Route.useParams()` | Route | Auto | Path params |
 | `Route.useSearch()` | Route | Auto | Search params |
 | `Route.useRouteContext()` | Route | Auto | Route context |
-| `useParams({ from })` | Global | Manual | 다른 라우트 params |
-| `useSearch({ from })` | Global | Manual | 다른 라우트 search |
-| `useMatch({ from })` | Global | Manual | 라우트 매치 정보 |
-| `useNavigate()` | Global | Auto | 네비게이션 |
-| `useRouterState()` | Global | Manual | 라우터 상태 |
-| `useLocation()` | Global | Auto | 현재 location |
+| `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 |
 
 </reference>

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

@@ -13,10 +13,10 @@
 <quick_reference>
 
 ```tsx
-// 기본 라우트
+// Basic route
 export const Route = createFileRoute('/about')({ component: AboutPage })
 
-// Loader + 동적 파라미터
+// Loader + dynamic params
 export const Route = createFileRoute('/posts/$postId')({
   loader: async ({ params }) => ({ post: await getPost(params.postId) }),
   component: PostPage,
@@ -78,10 +78,10 @@ routes/
 └── $.tsx               # Catch-all (404)
 ```
 
-| 파일명 | 경로 |
+| Filename | Path |
 |--------|------|
-| `index.tsx` | 디렉토리 루트 |
-| `$param.tsx` | 동적 세그먼트 |
+| `index.tsx` | Directory root |
+| `$param.tsx` | Dynamic segment |
 | `_layout/` | Pathless layout |
 | `$.tsx` | Catch-all |
 
@@ -89,27 +89,27 @@ routes/
 
 <options>
 
-| 옵션 | 설명 |
+| Option | Description |
 |------|------|
-| `component` | 렌더링할 컴포넌트 |
-| `loader` | 데이터 로드 함수 |
-| `beforeLoad` | 로드 전 실행 (인증 등) |
-| `validateSearch` | Search params 스키마 |
-| `pendingComponent` | 로딩 중 표시 |
-| `errorComponent` | 에러 발생 시 표시 |
-| `notFoundComponent` | Not found 시 표시 |
+| `component` | Component to render |
+| `loader` | Data loading function |
+| `beforeLoad` | Run before loading (auth, etc) |
+| `validateSearch` | Search params schema |
+| `pendingComponent` | Loading state component |
+| `errorComponent` | Error component |
+| `notFoundComponent` | Not found component |
 
 </options>
 
 <hooks>
 
-| Hook | 용도 |
+| Hook | Purpose |
 |------|------|
-| `Route.useLoaderData()` | Loader 반환값 |
-| `Route.useParams()` | Path 파라미터 |
+| `Route.useLoaderData()` | Loader return value |
+| `Route.useParams()` | Path parameters |
 | `Route.useSearch()` | Search params |
 | `Route.useRouteContext()` | Route context |
-| `useNavigate()` | 프로그래밍 네비게이션 |
-| `useMatch({ from })` | 라우트 매치 정보 |
+| `useNavigate()` | Programmatic navigation |
+| `useMatch({ from })` | Route match info |
 
 </hooks>

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

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

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

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

@@ -3,20 +3,20 @@
 <patterns>
 
 ```tsx
-// Zod 스키마 + 라우트
+// Zod schema + route
 const searchSchema = z.object({
-  page: z.number().catch(1),            // 기본값
-  search: z.string().optional(),        // 선택
+  page: z.number().catch(1),            // Default value
+  search: z.string().optional(),        // Optional
   sort: z.enum(['newest', 'price']).catch('newest'),
-  tags: z.array(z.string()).catch([]),  // 배열
+  tags: z.array(z.string()).catch([]),  // Array
   inStock: z.boolean().catch(true),     // Boolean
-  from: z.string().date().optional(),   // 날짜
-  minPrice: z.number().min(0).catch(0), // 범위
+  from: z.string().date().optional(),   // Date
+  minPrice: z.number().min(0).catch(0), // Range
 })
 
 export const Route = createFileRoute('/products')({
   validateSearch: searchSchema,
-  loaderDeps: ({ search }) => ({ search }),  // search 변경 시 loader 재실행
+  loaderDeps: ({ search }) => ({ search }),  // Re-run loader on search change
   loader: async ({ deps: { search } }) => fetchProducts(search),
   component: ProductsPage,
 })
@@ -26,11 +26,11 @@ const ProductsPage = () => {
   return <div>Page: {page}, Sort: {sort}</div>
 }
 
-// Link로 업데이트
+// Update via Link
 <Link to="/products" search={{ page: 1, sort: 'newest' }}>Reset</Link>
 <Link to="/products" search={prev => ({ ...prev, page: 2 })}>Next</Link>
 
-// useNavigate로 업데이트
+// Update via 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 - 인증 패턴
+# TanStack Start - Auth Patterns
 
 <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 } })
   })
 
-// Server Function에 적용
+// Apply to 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 통합
+// Better Auth integration
 export const auth = betterAuth({
   database: prismaAdapter(prisma),
   emailAndPassword: { enabled: true },

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

@@ -10,28 +10,28 @@
 
 ---
 
-## ⛔ 필수 규칙
+## ⛔ Required Rules
 
-| 금지 | 대신 |
+| Forbidden | Use Instead |
 |------|------|
-| /api 라우터 | Server Functions |
-| handler 내 수동 검증 | inputValidator |
-| handler 내 수동 인증 | middleware |
+| /api routes | Server Functions |
+| Manual validation in handler | inputValidator |
+| Manual auth in handler | middleware |
 
-✅ POST/PUT/PATCH → inputValidator 필수
-✅ 인증 필요 → middleware 필수
+✅ POST/PUT/PATCH → inputValidator required
+✅ Auth needed → middleware required
 
 ---
 
 ## Quick Reference
 
 ```typescript
-// GET + 인증
+// GET + Auth
 export const getUsers = createServerFn({ method: 'GET' })
   .middleware([authMiddleware])
   .handler(async () => prisma.user.findMany())
 
-// POST + Validation + 인증
+// POST + Validation + Auth
 export const createUser = createServerFn({ method: 'POST' })
   .middleware([authMiddleware])
   .inputValidator(createUserSchema)
@@ -43,14 +43,14 @@ export const Route = createFileRoute('/users')({
   loader: async () => ({ users: await getUsers() }),
 })
 
-// Loader 데이터 사용
+// Using Loader data
 const UsersPage = (): JSX.Element => {
   const { users } = Route.useLoaderData()
   return <div>{/* render */}</div>
 }
 ```
 
-### 구조
+### Structure
 
 ```
 routes/
@@ -59,9 +59,9 @@ routes/
 ├── users/
 │   ├── index.tsx       # /users
 │   ├── $id.tsx         # /users/:id
-│   ├── -components/    # 페이지 전용
-│   └── -functions/     # 페이지 전용 Server Functions
+│   ├── -components/    # Page-specific
+│   └── -functions/     # Page-specific Server Functions
 
-공통 함수 → @/functions/
-라우트 전용 → routes/[경로]/-functions/
+Shared functions → @/functions/
+Route-specific → routes/[path]/-functions/
 ```

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

@@ -1,24 +1,24 @@
 # TanStack Start - Middleware
 
-Server Function 및 라우트에 공통 로직 적용.
+Apply common logic to Server Functions and routes.
 
-## 기본 패턴
+## 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],  // 모든 요청
-  functionMiddleware: [loggingMiddleware], // 모든 Server Function
+  requestMiddleware: [globalMiddleware],  // All requests
+  functionMiddleware: [loggingMiddleware], // All Server Functions
 }))
 ```
 
@@ -57,7 +57,7 @@ export const startInstance = createStart(() => ({
 ```typescript
 export const Route = createFileRoute('/hello')({
   server: {
-    middleware: [authMiddleware], // 모든 핸들러
+    middleware: [authMiddleware], // All handlers
     handlers: { GET: async ({ request }) => new Response('Hello') },
   },
 })