Cursor rule

1---
2description: 
3globs: 
4alwaysApply: true
5---
6# TypeScript Best Practices
7 
8## Type Safety & Configuration
9 
10- Enable `strict: true` in [tsconfig.json](mdc:tsconfig.json) with additional flags:
11  - `noImplicitAny: true`
12  - `strictNullChecks: true`
13  - `strictFunctionTypes: true`
14  - `strictBindCallApply: true`
15  - `strictPropertyInitialization: true`
16  - `noImplicitThis: true`
17  - `alwaysStrict: true`
18  - `exactOptionalPropertyTypes: true`
19- Never use `// @ts-ignore` or `// @ts-expect-error` without explanatory comments
20- Use `--noEmitOnError` compiler flag to prevent generating JS files when TypeScript errors exist
21 
22## Type Definitions
23 
24- Do not ever use `any`. Ever. If you feel like you have to use `any`, use `unknown` instead.
25- Explicitly type function parameters, return types, and object literals.
26- Please don't ever use Enums. Use a union if you feel tempted to use an Enum.
27- Use `readonly` modifiers for immutable properties and arrays
28- Leverage TypeScript's utility types (`Partial`, `Required`, `Pick`, `Omit`, `Record`, etc.)
29- Use discriminated unions with exhaustiveness checking for type narrowing
30 
31## Advanced Patterns
32 
33- Implement proper generics with appropriate constraints
34- Use mapped types and conditional types to reduce type duplication
35- Leverage `const` assertions for literal types
36- Implement branded/nominal types for type-level validation
37## Code Organization
38 
39- Organize types in dedicated files (types.ts) or alongside implementations
40- Document complex types with JSDoc comments
41- Create a central `types.ts` file or a `src/types` directory for shared types
42