# @transitionsag/bloom

Bloom is a Solid component library built on `@transitionsag/seeds` primitives.

Read these files before generating Bloom code:

- `docs/llm/component-patterns.md`
- `docs/llm/styling-rules.md`
- `docs/llm/components/`

Core rules:

- Import components from `@transitionsag/bloom` unless a package subpath is explicitly preferred.
- Use the component anatomy shown in the matching component doc and Storybook story.
- Non-overlay surfaces use `bg-background`.
- Overlay surfaces such as popovers, dropdowns, hover cards, tooltips, tours, and floating menu content use `bg-surface` unless the component doc says otherwise.
- Preserve default visual children for indicators, arrows, checkbox icons, and triggers unless intentionally customizing them.
- Merge consumer classes with Bloom defaults; do not replace required anatomy classes in examples.
- Prefer copy-pasteable examples from `docs/llm/components/*.md` and `src/*/*.stories.tsx`.
