# 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