Copilot instructions

1---
2applyTo: 'src/lib/**/*.{ts,tsx}'
3---
4# Utility & Service Guidelines
5 
6## LIB ORGANIZATION RULES
7 
8### File Structure
9```
10src/lib/
11├── utils.ts          # General utilities (keep existing cn function)
12├── types.ts          # Shared TypeScript interfaces
13├── constants.ts      # App-wide constants
14├── validations/      # Zod schemas
15│   ├── user.ts
16│   ├── product.ts
17│   └── common.ts
18└── services/         # API service layer
19    ├── api.ts        # Base API client
20    ├── userService.ts
21    └── productService.ts
22```
23 
24### Utility Functions (utils.ts)
25```tsx
26// Keep existing cn function
27export function cn(...inputs: ClassValue[]) {
28  return twMerge(clsx(inputs))
29}
30 
31// Add other utilities
32export function formatDate(date: Date | string): string {
33  return new Intl.DateTimeFormat('en-US').format(new Date(date))
34}
35 
36export function debounce<T extends (...args: any[]) => any>(
37  func: T,
38  wait: number
39): (...args: Parameters<T>) => void {
40  let timeout: NodeJS.Timeout
41  return (...args: Parameters<T>) => {
42    clearTimeout(timeout)
43    timeout = setTimeout(() => func(...args), wait)
44  }
45}
46```
47 
48### Type Definitions (types.ts)
49```tsx
50// Shared application types
51export interface User {
52  id: string
53  email: string
54  name: string
55  avatar?: string
56  role: UserRole
57}
58 
59export interface ApiResponse<T> {
60  data: T
61  message: string
62  success: boolean
63}
64 
65export type UserRole = 'admin' | 'user' | 'guest'
66export type Theme = 'light' | 'dark' | 'system'
67```
68 
69### Constants (constants.ts)
70```tsx
71// Application constants
72export const API_ENDPOINTS = {
73  USERS: '/api/users',
74  PRODUCTS: '/api/products',
75  AUTH: '/api/auth',
76} as const
77 
78export const QUERY_KEYS = {
79  USERS: 'users',
80  PRODUCTS: 'products',
81  USER_PROFILE: 'user-profile',
82} as const
83 
84export const ROUTES = {
85  HOME: '/',
86  DASHBOARD: '/dashboard',
87  USERS: '/users',
88  PROFILE: '/profile',
89} as const
90```
91 
92### Validation Schemas (validations/)
93```tsx
94// validations/common.ts
95export const emailSchema = z.string().email('Invalid email')
96export const phoneSchema = z.string().regex(/^\+?[\d\s-()]+$/, 'Invalid phone')
97 
98// validations/user.ts
99export const userSchema = z.object({
100  name: z.string().min(2, 'Name too short'),
101  email: emailSchema,
102  phone: phoneSchema.optional(),
103})
104 
105export type UserFormData = z.infer<typeof userSchema>
106```
107