TypeScript Coding Guidelines

Typing

No any. No non-null assertions (!) unless the reason is documented in the code. Prefer explicit return types on all exported functions. Use generics over unknown casts.

// ❌
function parse(data: any): any { ... }

// ✅
function parse<T>(data: unknown): T { ... }

Interfaces and abstract classes

Define contracts explicitly. Use interface for pure shapes, abstract class