AGENTS.md

1# ui — minimal shared React utilities
2 
3Single-file library (`src/index.ts`). Exports two things: `cx()` (className joiner) and `surface`
4(Tailwind class constant for bordered card surfaces). Consumed by the web dashboard; built to `dist/` via `tsc`.
5 
6## Layout
7 
8- `src/index.ts` — sole source file; all exports live here
9- `dist/` — compiled output (gitignored); regenerated by `pnpm build`
10- `tests/index.test.mjs` — runtime contract for class filtering/order and surface tokens
11- `package.json` — ESM package, `main` points at `src/index.ts` for workspace consumers
12 
13## Conventions
14 
15- All new exports go in `src/index.ts` directly — no subdirectory structure
16- No runtime dependencies; React is a peer dep only
17- `pnpm test` builds `dist/`, then runs Node runtime tests
18- Build: `pnpm build` → `tsc --outDir dist`
19 
20## Gotchas
21 
22- Package is deliberately thin — do not add component files or third-party deps without strong reason
23- No UI components exist yet; `surface` is a raw Tailwind string, not a React component
24 
25See ../../CLAUDE.md (root)
26