GEMINI.md

Project

TypeScript project using ESM modules, Vitest for testing.

Conventions

• Strict TypeScript (noUncheckedIndexedAccess, exactOptionalPropertyTypes)
• ESM only — no CommonJS, no require()
• Prefer const assertions and satisfies operator
• Use branded types for IDs

File Structure

• src/ for source code
• tests/ for test files
• Barrel exports from index.ts per module

Commands

• pnpm test — run vitest
• pnpm build — tsc build
• pnpm lint — eslint + prettier check

Testing

• Vitest with happy-dom for DOM tests
• Mock external services with msw
• Aim for >80% coverage on business logic