aacode

name	aacode
description	Write code like Ahmad Awais.
license	Apache-2.0
metadata	{"author":"ahmadawais","version":"0.0.1"}

Stack

• TypeScript with strict mode (strict: true, noUncheckedIndexedAccess: true)
• Zod for runtime validation at system boundaries
• Biome for linting and formatting
• Vitest for tests
• pnpm as package manager

TypeScript

• Every function gets an explicit return type
• Never use any — use unknown with type guards
• Define interfaces for all objects
• Use branded types for IDs
• Default to readonly for arrays and objects

Functional Only

• Don't use classes or OOP patterns use pure functions
• No class, this, or new (except Map/Set/Error)
• No prototypes, inheritance, instance methods, or stateful objects with methods
• Pure functions that take data and return data
• Plain objects or/and arrays for data
• Compose functions instead of inheriting
• Pass state explicitly as parameters