Cursor rule

1---
2description: 
3globs: **/*.ts,**/*.tsx
4alwaysApply: false
5---
6# TypeScript Best Practices
7 
8## Type System
9- Prefer interfaces over types for object definitions
10- Use type for unions, intersections, and mapped types
11- NEVER use `any` or `as any` types or coercion
12- Use strict TypeScript configuration
13- Leverage TypeScript's built-in utility types
14- Use generics for reusable type patterns
15 
16## Naming Conventions
17- Use PascalCase for type names and interfaces
18- Use camelCase for variables and functions
19- Use UPPER_CASE for constants
20- Use descriptive names with auxiliary verbs (e.g., isLoading, hasError)
21- Prefix interfaces for React props with 'Props' (e.g., ButtonProps)
22 
23## Code Organization
24- Keep type definitions close to where they're used
25- Export types and interfaces from dedicated type files when shared
26- Use barrel exports (index.ts) for organizing exports
27- Place shared types in a `types.ts` file
28- Co-locate component props with their components
29 
30## Functions
31- Use explicit return types for public functions
32- Use arrow functions for callbacks and methods
33- Implement proper error handling with custom error types
34- Use function overloads for complex type scenarios
35- Prefer async/await over Promises
36- Prefer function declarations over function expressions.
37- Prefer functional programming over classes.
38 
39## Best Practices
40- Enable strict mode in tsconfig.json
41- Use readonly for immutable properties
42- Leverage discriminated unions for type safety
43- Use type guards for runtime type checking
44- Implement proper null checking
45- Avoid type assertions unless necessary
46 
47## Error Handling
48- Do not proactively add error handling
49- Handle Promise rejections properly
50