Cursor rule

1# TypeScript Standards
2 
3## Strict TypeScript Requirements
4 
5- Always use strict TypeScript mode
6- Never use `any` type - use proper type definitions
7- Use `unknown` instead of `any` when type is truly unknown
8- Always define proper interfaces and types for props, state, and API responses
9 
10## Type Definitions
11 
12- Define types in `src/types/` directory
13- Use descriptive type names (e.g., `ProductListing`, `UserProfile`)
14- Export types from dedicated type files
15- Use union types for finite sets of values
16- Prefer `interface` for object shapes, `type` for unions/intersections
17 
18## Component Props
19 
20- Always define `Props` interface for component props
21- Use `React.FC<Props>` or `React.ComponentProps<"div">` for component typing
22- Make props required unless they have default values
23- Use proper event types (e.g., `React.ChangeEvent<HTMLInputElement>`)
24 
25## Enum Usage
26 
27- Always use enums from `src/constants/enums.ts` for consistent values
28- Never hardcode string values that exist in enums
29- Use enum values for API calls, form validation, and conditional logic
30- Export enum types for use in other files
31 
32## Context Typing
33 
34- Define proper types for context values and setters
35- Use `createContext<T>` with proper generic types
36- Define context provider props interface
37- Use proper typing for context consumers
38 
39## API and Service Types
40 
41- Define types for all API request/response shapes
42- Use proper typing for Supabase operations
43- Define error types and handle them appropriately
44- Use generic types for reusable service functions
45 
46## Example Patterns
47 
48```typescript
49// Good: Proper interface definition
50interface ProductCardProps {
51  product: Product;
52  onAddToCart: (productId: string) => void;
53  variant?: "default" | "compact";
54}
55 
56// Good: Using enums
57const status = LISTING_STATUS.APPROVED;
58 
59// Good: Proper event typing
60const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
61  setValue(e.target.value);
62};
63```
64 
65description:
66globs:
67alwaysApply: false
68 
69---
70