TypeScript Code Style Guide

Types and Type Safety

• Avoid explicit type annotations when TypeScript can infer
• Avoid implicitly any; explicitly type when necessary
• Use accurate types: prefer Record<PropertyKey, unknown> over object or any
• Prefer interface for object shapes (e.g., React props); use type for unions/intersections
• Prefer as const satisfies XyzInterface over plain as const
• Prefer @ts-expect-error over @ts-ignore over as any
• Avoid meaningless null/undefined parameters; design strict function contracts

Async Patterns

• Prefer async/await over callbacks or .then() chains
• Prefer async APIs over sync ones (avoid *Sync)
• Use promise-based variants: import { readFile } from 'fs/promises'
• Use Promise.all, Promise.race for concurrent operations where safe