Clean TypeScript

We use TypeScript as a correctness and clarity tool, not as ceremony. Types should reduce bugs and cognitive load.

Type Philosophy

• PREFER explicit, readable types over clever or overly generic ones
• AVOID any and unsafe type assertions
• Use unknown instead of any when necessary
• Let TypeScript infer types when inference is clear and stable

Types & Interfaces

• PREFER type aliases for most use cases
• Use interface primarily for public, extendable object shapes
• Keep types small, composable, and well-named

Functions & APIs